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Welcome! 

Welcome to SunOS 4,1.2. This 
preface describes how this 
manual is organized, with brief 
descriptions of each section. 
The manual has five parts: 

• Introduction 

• Features 

• Installation and System 
Configuration 

• Open Issues 

• Appendixes 


Introduction 

What is in this manual? What 
should you do before installing 
this release? Part 1 has one 
chapter, which contains the fol¬ 
lowing sections: 

• Release Compatibility 

• Workstation and Machine 
Architecture Terminology 

• Getting Help 

• Guide to Publications 

• Documentation Conven¬ 
tions 




Features 

What is new in SunOS 4.1.2? 
Part 2 contains detailed descrip¬ 
tions of all new features and 
changes. It also describes all 
bugs that have been fixed since 
SunOS 4.1,1 Rev B. This part 
contains the following chapters: 

• New Software Features 

• About Openwindows 

• New Hardware Features 

• Open Boot PROM 2.0 and 
Hierarchical Device Nam¬ 
ing 

• Bugs Fixed in SunOS 
4.1.2 






Installation and 

System 

Configuration 

Use Part 3 along with other ins¬ 
tallation documents when instal¬ 
ling SunOS 4.1.2. This part 
contains the following chapters: 

• Installation Notes and 
Warnings 

Notes and warnings about 
installing unbundled pro¬ 
ducts. 

• System Configuration 

Hints for kernel 
configuration and for 
improving system perfor¬ 
mance. 



Open Issues 

Part 4 contains the latest infor¬ 
mation on this SunOS release. 
Be sure to read this material, 
which is separate from the 
Release Manual in the Release 
Minibox, and be sure to insert it 
behind the Open Issues tab. This 
part contains the following 
chapters: 

• Late-Breaking News 

Includes the latest news 
about SunOS 4.1.2 

• Known Problems 

Describes any known prob¬ 
lems in the release 


Appendixes 

Refer to this part for detailed 

information about: 

• Documents Available for 
Use with SunOS 4.1.2 

• Addendum to Writing 
Device Drivers 

• Sundiag Version 2.3 for 
SunOS 4.1.2 

• X/Open Conformance 
Statement for SunOS 4.1 
Products Receiving the 
XPG3 Component Brand 
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Part 1 — Introduction 


Read Part 1 to get a quick introduction to the release, including pointers to other 
parts of the Release Manual and to other documentation. Read Part 2, Features, 
for a detailed description of the release, and Parts 3 and 4, Installation and Open 
Issues, for the latest information about installing and using the release. 

Chapter 1, “Introduction,” includes the following sections: 

• Release Compatibility 

• Workstation and Machine Architecture Terminology 

• Getting Help 

• Guide to Publications 

• Documentation Conventions 







Introduction 


Welcome to SunOS™ 4.1.2. This software release includes the following: 

• Support for the new SPARCsystem 600MP series of systems 

• An incremental software upgrade program (from SunOS 4.1.1 and 4.1.1 Rev 

B) 

• Incorporation of SunOS 4.1.1 Rev B and SunOS 4.1.1 GFX releases 

• More than 200 SunOS bug fixes 

SunOS 4.1.2 is released on all SPARC™ platforms (CD-ROM only), and is fully 
compatible with SunOS 4.1.1 and SunOS 4.1.1 Rev B. See “New Software 
Features” for a detailed description of the new software features and “New 
Hardware Features” for a detailed description of the newly-supported hardware. 

Be sure to read the material in the Open Issues package from the SunOS Release 
Minibox before proceeding with the installation or upgrade; this package, 
comprised of Chapter 9, “Late-Breaking News,” and Chapter 10, “Known Prob¬ 
lems,” may contain material that corrects or supersedes information in this 
manual. Insert the Open Issues package into this manual behind the Open Issues 
tab. 

In addition. Desktop SPARCsystem owners may want to consult the appropriate 
Desktop SPARC Installation Guide and other Sun documentation during the 
installation. 

1.1. Release Compatibility SunOS 4.1.2 is fully binary compatible with SunOS 4.1 and subsequent 4.1.X 

releases; all applications written for SunOS 4.1, SunOS 4.1.1, or SunOS 4.1.1 
Rev B will run on the SunOS 4.1.2 release without change. 

SunOS 4.1.2 Binary User executables (including shared libraries), sources, and object files from 

Compatibility with SunOS 4.1 SunOS 4.1, SunOS 4.1.1, or SunOS 4.1.1 Rev B should move to SunOS 4.1.2 

with no change. This includes many Sun and third-party unbundled products. 
The rare exceptions to this are programs, whether in source, object, or executable 
form, that depend upon the internal implementation of the kernel and its data 
structures. Programs that use the kvm library are likely to be in this class. 
Although many of these programs will still run, the data they access through the 
library may have changed in ways that can affect the functioning of the program. 
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In addition, programming that modifies the implementation of the system, espe¬ 
cially kernel extensions or modifications, may require some conversion. Device 
drivers that use interface routines published in the Writing Device Drivers 
manual should require no modification. However, all kernel modifications 
should be inspected to verify that the aspects of system implementation they rely 
upon have not been altered. See Appendix B for more about device drivers. 

Lastly, a bug fix in the link-edit or provided with 4.1.2 may reveal previ¬ 
ously masked errors with incorrectly constructed shared libraries. These will 
manifest themselves as references to undefined symbols. See “Link-editor Bug 
Fixes” in Chapter 2 for more detail. 

Binary Compatibility with 
SunOS 4.0.x 


• Depend upon the internal implementation of the kernel and its data struc¬ 
tures: 

• Depend upon the object file format in a way that can be confused by extra 
information now appearing at the end of some object files in support of 
#ident directives in C source programs; 

• Rely upon implementation attributes, such as the location, existence, or for¬ 
mat of certain files not documented as part of the system’s programming 
interface (such as temporary files created by library functions or utilities). 

Programs that use the kvm library are likely to be in the first class of programs 
described above; although the programs may still function, the data they access 
through the library may have changed in ways that will affect the function of the 
program. Examples of such data include the proc and user structures of the 
system. 

Further, programming that modifies the implementation of the system, in particu¬ 
lar kernel extensions or modifications, may require some conversion. Most 
drivers should work simply through recompilation, although other kinds of 
changes should be inspected to verify that whatever aspect of the system imple¬ 
mentation they rely upon for their operation has not been altered. 

Note that while it is possible, as always, to move earlier programs (their sources, 
objects, and executables) forward to SunOS 4.1.2, it is not possible to move 
SunOS 4.1, 4.1.1, 4.1.1 Rev B, or 4.1.2 programs back to SunOS 4.0.X or earlier 
releases. In SunOS 4.1, 4.1.1, 4.1.1 Rev B, and 4.1.2, this extends to newly 
created filesystems, which incorporate updates from the Berkeley 4.3 BSD 
“Tahoe” release that change the on-disk format of the filesystem. Such filesys¬ 
tems cannot be directly connected to pre-4.1 systems, though network access to 
them is unaffected by this change, and tapes made via dump and tar and similar 
utilities are also unaffected. 


User executables (including shared libraries), sources, and object files from 4.0.X 
releases should move to SunOS 4.1.2 with no change. This includes many Sun 
and third party unbundled products. There are exceptions to this that should, in 
practice, be encountered rarely. These are programs (in any of source, object, or 
executable forms) that: 
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1.2. Workstation and Since SunOS 4.0.3, an important distinction has been made between the applica- 

Machine Architecture tion architecture and the kernel architecture of a machine. In this and other 

Terminology documents, the distinction is frequently used in discussing workstation features 

and installation procedures. 


Application and Kernel 
Architecture 


SunOS 4.1.2 supports only the sun4 application architecture (Sun-4, Sun-4c, 
Sun-4m). (Application and kernel architectures are identified by “sun” in lower 
case letters followed without a space by “3” or “4” and, optionally, a letter — 
“sun4c,” “sun4m,” “sun3x”.) Sun-4, Sun-4c, or Sun-4m servers running 4.1.2 
will fully support Sun-3 clients running SunOS 4.1, 4.1.1, or 4.1.1 Rev B. 

All systems with sun4 application architecture are built around Sun’s SPARC 
processor. All SPARCsystems can run the same application binaries. Similarly, 
application binaries that run on one sun3 system will run on all other sun3s. 
However, application binaries generated on a SPARCsystem will not run on a 
sun3 system. 

Not all systems with sun4 application architecture have the same kernel architec¬ 
ture. For example, the SunOS kernel that runs on a SPARCstation 1 or 
SPARCstation 2 will not run on a SPARCstation 470 nor SPARCserver 490, nor 
will it run on SPARCsystem 600MP series machine. Both the SPARCstation 1 
and SPARCstation 2 have sun4c kernel architecture. Systems such as the 
SPARCserver 490 and SPARCstation 470 have sun4 kernel architecture, and 
SPARCsystem 600MP series machines have sun4m kernel architecture. 

There are also two separate kernel architectures corresponding to sun3 applica¬ 
tion architecture: sun3x kernel architecture and sun3 kernel architecture. 

In commands and screen examples, this and other documents may refer to 
machine architectures as a-arch (application architecture) and k-arch (kernel 
architecture). These are often combined as a-arch.k-arch pairs, for example: 
sun4.sun4c. The following table shows application and kernel architectures for 
Sun systems. 


Every Sun system has an application architecture and a kernel architecture. 
Application architecture refers to the way in which systems interpret the binary 
code generated by application software. Two systems have the same application 
architecture if they can both run the same application binaries. Kernel architec¬ 
ture refers to the hardware-specific portion of a SunOS kernel. Two systems 
have the same kernel architecture if the same SunOS kernel will run on both of 
them. 
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Table 1-1 System Architectures and Machine Names 


Machine Name 

a-arch 

k-arch 

Sun-4/100 & Sun-4/200 series 

SPARCsystem 300 and 400 series 

sun4 

sun4 

SPARCstation 1, SPARCstation l-i-, SPARCstation 2, 
SPARCstation IPC, SPARCstation IPX 

SPARCstation SLC, SPARCstation ELC 

SPARCserver 1, SPARCserver 1+ 

SPARCserver 2, SPARCserver IPC, SPARCserver SLC 

sun4 

sun4c 

SPARCsystem 600MP series 

sun4 

sun4m 

Sun-3/50, Sun-3/60, Sun-3/75, Sun-3/100 series. 

Sun-3/200 series 

sun3 

sun3 

Sun-3/80, Sun-3/400 series 

sun3 

sun3x 


1.3. Getting Help If you have problems installing or using SunOS 4.1.2, call Sun Microsystems 

with the information outlined below. In the United States you can call 1-BOG¬ 
US A-4-SUN; outside the U.S., contact your local Sun Answer Center or your 
Sun sales representative for assistance. 

You Will Need to Provide the Following Information: 

• Your name and electronic mail address (if any) 

• Your company name, address, and phone number 

• The model and serial number of your workstation 

• Additional information provided by the showrev(8) command (described 
in Chapter 2 of the Release Manual and in the man page for showrev(8). 

- your system’s hostname 

- hostid 

- kernel and application architecture 

- SunOS release number 

- kernel revision 

• Any information that may help to diagnose the problem. 

Call your sales representative if you have questions about Sun support services or 
your shipment. 
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1.4. Guide to Publications If you have a new Sun system or if you have been running a release prior to 

SunOS 4.1, you should have available the full SunOS 4.1.X set of Sun software 
manuals. Two boxes in the set are of particular importance for installing and 
running this release: the SunOS Release Minibox and the OpenWindows End 
User’s Manuals. 

Note that the Release Minibox is the only box of the full SunOS 4.1.X set that 
changed between SunOS 4.1.1 and SunOS 4.1.1 Rev B, and again between 
SunOS 4.1.1 Rev B and SunOS 4.1.2. In addition to the Release Manual, the 
Release Minibox contains Installing SunOS 4.1.2 System Software, with detailed 
instructions for performing a custom installation of SunOS 4.1.2, a quick installa¬ 
tion of a predefined version of SunOS 4.1.2 on a standalone workstation, or an 
upgrade of a SunOS 4.1.1 or 4.1.1 Rev B system to SunOS 4.1.2. 

For a description of the manuals provided in the full SunOS 4.1.X set, other than 
those mentioned above, see Appendix A. 


1.5. Documentation The following documentation conventions are used in this manual. 

Conventions 


. cshrc Could Be In most cases, whenever . cshrc is mentioned in this manual, . profile may 

. prof ile be substituted if you are using the Bourne shell. 

Type Styles This manual uses different type styles, or fonts, to distinguish between informa¬ 

tion you type from the keyboard, information the system displays, and variables 
(items that must be replaced by a value). 

• listing 

Represents a system response that is displayed on your monitor or terminal 
screen. Listing font is also used for literal values (such as the names of files 
or utility programs) and for file listings and session output. 

• bold listing 

Represents characters you type from the keyboard. 

• italic 

Represents variables, for which you must substitute values. Also used for 
emphasis, particularly when introducing new terms. 


Boxes Boxes are used to display information as it appears on your video display. 

• Unshaded boxes represent screen displays, system responses, or file listings. 
They do not contain entries or responses made by a user. 
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standard daemons: update cron, 
starting network daemons: inetd printer. 

Sat Mar 17 13:40:15 PDT 1990 

gemini login: 

V_ ) 


• Gray boxes represent a dialog between you and your workstation. Your 

entries are shown in bold listing font, system responses are shown 

in regular listing font. 


Enter name of client machine: opusone , 

Enter name of server: fourfox 

V_ ) 



• Exploding Workstation 

Marks information that it is imperative for you to read. If you skip over this 
material, you may damage your system or jeopardize the installation. 



• Pointing Hand 

Points to information that requires close attention. 
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Part 2 — Features 


Part 2 tells you what is new about SunOS 4.1.2. It includes the following 
chapters: 

• Chapter 2, “New Software Features” 

• Chapter 3, “About OpenWindows” 

• Chapter 4, “New Hardware Features” 

• Chapter 5, “Open Boot PROM 2.0 and Hierarchical Device Naming” 

• Chapter 6, “Bugs Fixed in SunOS 4.1.2” 






New Software Features 


SunOS 4.1.2 includes the following software enhancements; 

• SPARCsystem 600MP series systems support 

• Software upgrade utility (described in Installing SunOS 4.1.2 System 
Software) 

• Support for OpenWindows Version 2 and Version 3 (described in Chapter 3) 

• Support for a number of graphics devices 

• Quicker file system checks during reboot 

• Support for Rock Ridge file system on a CD-ROM 

• Availability of BSD 4.3 mal loc 

• link-editor bug fixes 

• 200+ bug fixes, including fixes for graphics devices 

2.1. General Software Software changes other than those supporting SPARCsystem 600MP series sys- 

Changes terns are described below; SPARCsystem 600MP series changes are described in 

the following section. 


Sunupgrade for Upgrading to SunOS 4.1.2 includes sunupgrade for upgrading from SunOS 4.1.1 or SunOS 

SunOS 4.1.2 4.1.1 Rev B. See “Upgrading to SunOS 4.1.2” in Installing SunOS 4.1.2 System 

Software for a complete description of the upgrade procedure. 

Graphics Support and Fixes SunOS 4.1.2 incorporates all functionality and fixes from the 4.1.1 -GFX Rev. 1 

and 4.1.1-GFX Rev.2 releases. This includes Sun-4c support for the GS, GT, and 
GXplus graphics accelerator boards and the TC frame buffer, plus Sun-4 support 
for the previously-unbundled VX graphics accelerator board, and Sun-4m sup¬ 
port for the single-slot GX graphics accelerator and MGl frame buffer. 

Quicker File System Checks SunOS 4.1.2 includes the functionality of Sun QuickCheck 2.0, which was form¬ 
erly an unbundled product. Basically, f sck runs more quickly because the code 
has been rewritten to speed up file system checking, and because file systems are 
checked periodically (usually once every 30 seconds), and those marked as 
“clean” or “stable” are not checked when f sck is run in “preen” mode, and dur¬ 
ing reboot. The superblock of each file system contains a "clean flag" that is set 
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whenever the file system is known to be in a stable state (following a sync, for 
example). 

See the man pages for f sck(8), f stab(5), dumpf s(8), and quotacheck(8) 
for details. 

Rock Ridge File System Sun’s hsf s file system (ISO 9660) now supports the Rock Ridge file system 

Supported on CD-ROM extensions. This will allow any Rock Ridge CD-ROM to look like full UNIX file 

systems, with long file names, case sensitivity, symbolic links. Block and Char¬ 
acter devices, and other UNIX file system features. The only file system exten¬ 
sion it does not support is writing to the CD-ROM file system itself. 

BSD 4.3 malloc Available By default, when malloc () is invoked, the Sun version, found in libc, is run. 

This version of malloc () is more efficient in space than the BSD 4.3 version 
of the command, but it is not as efficient in speed. 

The BSD 4.3 version of malloc () , realloc () and free () which are 
optimized for speed rather than space,are available in 

/usr/lib/libbsdmalloc . a. For programs where memory usage is less of 
an issue than execution speed, use the BSD 4.3 versions of malloc (), real¬ 
loc () and f ree () by explicitly compiling your programs with the - 

Bstatic -Ibsdmalloc flags. 

The malloc () , realloc () , and free ( ) routines in libbsdmalloc . a 

are defined like the libc versions: 

char *malloc(size) 
unsigned size; 

int free(ptr) 
char *ptr; 

char *realloc(ptr, size) 
char *ptr; 



Note the following caveats about libbsdmalloc: 

• Compiled binaries will not be SCD/ABI-compliant (because sbrk (), 
which is not in the ABI, is called) 

• Other malloc -related routines defined in 4.X, such as calloc (), 
memalign,mallopt(), and mallinfo(), will not work 
with libbsdmalloc. 


2.2. Link-editor Bug Fixes A number of bugs have been fixed in both the static and dynamic link editors. 

All of these fixes have been previously available in patches to /usr/bin/ld 
and /usr/lib/ld.so;the SunOS 4.1.2 editions of these completely super¬ 
sede all SunOS 4.1 and SunOS 4.1.1 patches. See Chapter 7 for instructions for 
installing language patches. 
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In almost all cases, these changes simply cause the loader(s) to perform in accor¬ 
dance with the behaviors specified in the manuals; there are no enhancements or 
other functional changes as a result of these repairs. 

However, one of the repairs corrects a problem (Bug ID 1019004) and reveals 
bugs in other parts of the system — bugs previously masked by the incorrect 
behavior of the loader. Another repair (to Bug ID 1052428) restricts the behavior 
of the dynamic loader library search algorithm for set-user- or set- 
group- id programs. Both of these are discussed in more detail below. 

As described above, the fix repairing bug 1019004 ("assert definitions can fail to 
report undefined symbols") can reveal other problems previously masked by the 
bug. Specifically, this bug allowed the construction of programs that silently per¬ 
mitted inclusion of shared libraries having unresolved references. The bug fix 
makes the link editing of programs using such libraries now report errors where 
previously the link editing operation appeared to have completed successfully. 

In many cases, particularly in the case of affected libraries in Sun products, the 
unresolved references were never actually used. Thus no real problem ever 
appeared, even though such libraries are, strictly speaking, incorrectly con¬ 
structed. However in other cases, such as for users reporting 1019004, the failure 
to report the unresolved reference permitted users to believe they had correct pro¬ 
grams, only to find out that they were not correct when, during execution, the 
dynamic link editor would suddenly report the unresolved reference. 

This can manifest itself with various Sun libraries in the -Bdynamic binding 
mode (the default), as follows: 

• Sun FORTRAN: if a program uses the 1 ibF7 7 library, but is not built as a 
FORTRAN program (i.e., not linked with an f 77 command), you can expect 
to see an undefined symbol reference for MAIN_. 

• Sun Pascal: if a program uses the Pascal library, but is not built as a Pascal 
program (i.e., not linked with a pc command), you can expect to see an 
undefined symbol reference for program. 

• Sun PHIGS: you can expect to receive an undefined symbol reference to 

phg_sin_set_no_input_cursor. 

• Sun Modula-2: If a Modula-2 program is linked dynamically it requires that 
libtermcap also be linked. 

Note that using a FORTRAN or Pascal main program will not produce diagnos¬ 
tics; this will happen only in the special cases of using their libraries from (for 
example) a C main program. 

In all cases where the error occurs, you can safely ignore the error if it is the only 
undefined symbol reported. Your executable will be marked as “executable”, but 
the linker will return a non-zero error, thus causing makefiles to terminate abnor¬ 
mally. A workaround for this problem is to define the undefined symbol in your 
application. For example, if your C program links with the Fortran library, it will 
now have an undefined symbol of MAIN_. In your C program you could define a 
subroutine: 
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This would satisfy the undefined external reference. The same could be done for 
Pascal by defining a routine: 



If you do not want to use the Sun FORTRAN or Sun Pascal workaround, updated 
versions of the Fortran and Pascal libraries are supplied with your SunOS 4.1.2 
distribution and should be applied after your upgrade (or any new installation or 
re-installation of 4.1.2 occurs). See Section 7.15 in Chapter 7 for more informa¬ 
tion. 

Undefined external references may also occur with user and third-party supplied 
shared libraries. In some of these cases, the undefined symbols may have no 
practical value — as the program may never actually use the code paths that 
reference the undefined symbol (this is the case with the Sun-supplied libraries.) 
In this event, the diagnostic from the loader may be ignored and the program exe¬ 
cuted anyway (unless there is some other diagnostic that prevents completion of 
link editing.) Note, however, that if a code path accessing any undefined symbol 
is actually used, the dynamic link editor will abort the program at the time the 
symbol is referenced (or immediately upon start-up if the reference is from a data 
structure.) 

In the case of bug 1052428 (“Id.so usage of -L options confusing, leads to secu¬ 
rity probs”), the dynamic loader’s usage of stored search paths specified by "-L" 
options to Id has been restricted to the use of absolute path names (names begin¬ 
ning with "/") when running a set-user- or set-group-ID program. 

Summary of bugs fixed in /usr/bin/ld: 

1019004 assert definitions can fail to report undefined symbols 
1032739 Id core dumps with many libs in multiple directories 
1034788 -r and -pic do not mix bad secondary magic number error 
1034833 Id: can’t mixed -r with -Bstatic or -A flag 
1037879 Cannot create executable with shared object which points 
to another shared object. 

1041946 (duplicated by 1065275, below). 

1042261 Id only recognized first directory in LD_LIBRARY_PATH 
1044524 multiply defined symbols and seg. fault caused by 4.1’s Id 
1045272 Id -u & -r do not seem to work properly 
1046462 Id fails with segmentation fault when processing nested 
#include files 

1050594 fix uninitialized structure entries. 

1064820 Id can produce bogus diagnostics when processing cascaded 
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dependencies 

1065275 program dumps core with shared objects having only statics. 

Summary of bugs fixed in /usr/lib/ld. so: 

1033086 Calling dlopen() on a file with BSS kills your application. 
1043300 dlclose prevents access to functions even after further dlopen 
1045194 dlsym returns bad address for uninitialized global variable 
1046379 cannot call a function in a [.so] from a function in another 
1052428 Id.so usage of -L options confusing, leads to security probs 


2.3. SPARCsystem 600MP This section has two subsections: the first subsection lists and describes new 
Systems SPARCsystem 600MP hardware support and software features; the second sub¬ 

section briefly describes the SPARCsystem 600MP multiprocessing environ¬ 
ment. 


Description of New Features 


• New commands (mpstat (1) and mps (1)). 

The command mpstat shows average and per-processor percentage usage 
data during a time interval. The command mps displays the status of current 
processes on an MP system. See the man pages for these commands for 
details. 

• Extended SCSI device support for SPARCsystem 600MP series 

The SunOS 4.1.2 GENERIC sun4m kernel configuration file declares support 
for five SCSI buses. 

• Open boot PROM support for SPARCsystem 600MP series machines 
See Chapter 5 for a discussion of the open boot PROM and its use. 

• New version of Sundiag 

The latest version of Sundiag, version 2.3, is included in SunOS 4.1.2. Sun¬ 
diag 2.3 features a new multiprocessor test, mptest, for validating 
SPARCsystem 600MP multiprocessing hardware. See Appendix C for a 
description of the new features and enhancements of Sundiag 2.3. 

Note that Sundiag 2.3 is SunView-based; it will not run in OpenWindows. 

If Openwindows is running, you must quit the window system. You can then 
run Sundiag from the monitor prompt (no window system) or you can run 
Sundiag from the SunView window system. 

• New kernel configuration files for SPARCsystem 600MP series systems: 

The following kernel configuration files are available for various system 
configurations: 

- DL: diskless Sun-4m system 

- NFS: Sun-4m with SCSI disks and tape; boot from server 

- SDST: Standalone Sun-4m with SCSI disks and tape 

- IDST: Sun-4m with IPI disks and SCSI tape 


^sun 

microsystems 


Revision A of December 1991 



2-6 SunOS 4.1.2 Release Manual 


The SPARCsystem 600MP SunOS 4.1.2 has been modified and tuned to function on multiprocessor (MP) 

Multiprocessing Environment hardware. The changes made to the kernel take advantage of the multiprocessing 

capability, yet provide complete binary compatibility with SunOS 4.1, 4.1.1, and 
SunOS 4.1.1 Rev B. The interfaces provided to the user in the form of libraries, 
system calls, and commands have not changed from SunOS 4.1.1 Rev B; two 
commands — mpstat ( 1 ) and mps ( 1 ) — have been added. Systems will 
automatically have increased throughput from the MP hardware, under appropri¬ 
ate applications. 


How MP Works The 600MP series uses a tightly-coupled, shared-memory configuration model. 

Several CPUs share real memory, but all processes have their own virtual address 
space and the kernel memory management system controls virtual-to-real address 
translation. Only one copy of the operating system exists, and is shared by all 
the processors. Interrupts can be serviced by any processor, and processors can 
send each other interrupt signals. 

The Operating System Processors accessing kernel data structures and code do so after acquiring locks 

that prevent other processors from accessing the same data structures or execut¬ 
ing the same code concurrently. Various optimizations have been made to 
minimize the overhead due to synchronization. 

Application Programs Application programs running in user mode have their own virtual address space 

and do not have to worry about shared memory synchronization. Several such 
applications can run concurrently on separate processors. In these cases addi¬ 
tional processors will provide almost linear increases in the system’s overall 
throughput. 

Applications that enter the kernel to utilize system resources will have to go 
through the additional overhead of synchronization; therefore, a mix of applica¬ 
tions that spends a large proportion of its time executing in the kernel will have 
lower throughput than a mix of applications that spends a small proportion of its 
time in the kernel. 

2.4. Writing Device Drivers See Appendix B for information about writing device drivers for SPARCsystem 
for SPARCsystem 600MP systems. 

600MP Systems 
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About OpenWindows 


OpenWindows Version 2 is the default window system for SunOS 4.1.2, and is 
included on the SunOS 4.1.2 release CD; pre-installed systems with adequate 
disk space will be installed with OpenWindows Version 2. 

OpenWindows Version 3 is co-packaged with SunOS 4.1.2; it is on a separate 
CD in the media box, along with the XGL 2.0 RTE software. 

This chapter includes information about OpenWindows Version 2 and OpenWin¬ 
dows Version 3. See Chapter 10 in the Open Issues packet in the Release Mini¬ 
box for known problems with Versions 2 and 3. 

3.1. Why Use Consider switching to OpenWindows Version 3 if the following new features and 

OpenWindows Version functions are important to you: 

3? 

• 24-bit graphics support for sophisticated color applications 

• Fast, direct access to hardware for graphics-intensive applications 

• 8-bit internationalization capability 

• Enhanced DeskSet 3.0 

• ToolTalk, a new state of the art tool for inter-application communication 

• Improved application integration through new network-transparrent drag- 
and-drop mechanism 

• 3D look and feel 

• Mouseless support 

• Audio capability in deskset environment 

• Easy migration to SVR4 

See the following documents to learn how to install and use OpenWindows Ver¬ 
sion 3: 

• OpenWindows Version 3 Installation and Start-Up Guide (PN 800-6029-10 

• CDmanager and CDM 2.0 User’s Guide (PN 800-6174-10) 
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3.2. General 

OpenWindows 

Features 


X Window System 


News 


XView Toolkit 


News Toolkit 
OPEN LOOK Interface 


OPEN LOOK Intrinsics 
Toolkit 

OpenWindows DeskSet 
Environment 


OpenWindows includes the following features: 

• XI 1/NeWS, a merger of two independent window system protocols 

• XView Toolkit 

• News Toolkit (TNT) 

• The OPEN LOOK user interface 

• OPEN LOOK Intrinsics Toolkit (OLIT) 

• OpenWindows DeskSet Environment 


XI1 is version 11 of the X Window System developed at MIT, The X Window 
System is the industry standard for a network-based, operating-system indepen¬ 
dent window system. 

NeWS is the “Network extensible Window System” developed by Sun and origi¬ 
nally offered as a separate window system. 

The XView Toolkit is a development toolkit that goes with the XI1 side of 
XI 1/NeWS. It is used to produce XI1 applications based on the OPEN LOOK 
graphical user interface. 

The NeWS Toolkit is a new toolkit for NeWS programmers. 

The OPEN LOOK interface is a set of specifications that define consistent visual 
and operational features; it gives a uniform look and feel to all OpenWindows 
applications. 

The OPEN LOOK Intrinsics Toolkit is a user interface toolkit based on MIT’s X? 
Intrinsics. 

The OpenWindows DeskSet Environment provides mouse-oriented and 
icon-oriented tools in the OPEN LOOK for standard functions and services such 
as: 


• File management (opening, closing, copying, moving files, etc.) 

• E-mail 

• System and CPLf performance monitoring 

• Calendar display and scheduling 

• Printing files and mail messages 
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3.3. About OpenWindows 
Version 2 


Note the following about OpenWindows Version 2. See Chapter 10 for a listing 
and descriptions of known problems with OpenWindows Version 2. 


Do Not Install Sun IPX 
Supplement 


SunOS 4.1.2 OpenWindows Version 2 includes the Sun IPX supplement; do not 
install this patch after installing SunOS 4.1.2. 


Keyboard Map File for 
Japanese International 
Keyboard 


The keyboard map file for the Japanese international keyboard is Japan4 . ps. 
See Chapter 3 of the OpenWindows Installation and Start-Up Guide for more 
information. 


If you require maximum levels of security, use the SunView window system. 
SunView, which is a kernel-based window system, presents a more secure 
environment than a networked window system such as OpenWindows. (Refer to 
the OpenWindows Version 2 Release Notes, page 13, for a detailed description of 
OpenWindows security.) 

The features and use of OpenWindows are fully described in the manuals in the 
OpenWindows End User’s Kits provided with the SunOS 4.1.2 Release Minibox 
(SX-9E). If you plan to use OpenWindows, you should make sure that you have 
this documentation. 

3.4. Which Default Depending on how your system is set up, one of the following scenarios will be 

Window System? played out when you log in; 

• New user logging in for the first time; OpenWindows comes up as the 
default window system 

• New user logging in for the first time; SunView comes up as the default win¬ 
dow system 

• New user logging in for the first time; system offers choice of SunView or 
OpenWindows as default system 

• New user logging in for the first time; no default window system. User 
receives a shell prompt after logging in 

• Old user logging in for the first time under this new operating system; old 
home directory was backed up and restarted. User gets same window system 
he/she previously had 

Each situation is covered separately in the following sections. 

If you are a new user on a SunOS 4.1.2 system and the "openwin" executable can 
be found, OpenWindows Version 2 will be your default window system. Note 
that this setting occurs in the . cshrc (or . prof ile) file in your home direc¬ 
tory. Note also that the desktop program, described below, can easily change 
your default window system. 

When you log in, you will see the message: 


New User; OpenWindows 
Comes Up as Default 


Using SunView for Maximum 
Security Levels 
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- 

starting OpenWindows (Control-C to interrupt) 
v_/ 


If you do not interrupt with [ Control-C ] . OpenWindows will come up after a short 
delay. 

You should now check to make sure that the OpenWindows Calendar Manager 
has been initialized: 

• Display the Workspace Programs menu by moving the mouse cursor to a 
screen background area and pressing the right mouse button 

• Drag the cursor to the right edge of the Programs option to display the Pro¬ 
grams submenu 

• Select the Calendar Manager 

If the Calendar Manager has not been initialized, at the bottom of your screen, 
below the calendar, you will see the error message: 


- 

rpc.cmsd is not responding... have you run install_cmgr? 

V_ J 


If you do not see the message, do not run ins t al l_cmgr . If it has been run 
previously, running it again causes problems. If the message is displayed, you 
need to take the following steps: 


• Become superuser and run install_cmgr: 



>1 



Pa s sword : [ enter root password] 

#/usr/openwin/bin/xview/install_cmgr 


1 

J 


• Exit OpenWindows 

• Log back in to your system and let OpenWindows come up again 


New User; SunView Comes If you are a new user on a SunOS 4.1.2 system and the openwin executable 

Up as Default cannot be found, SunView will be your default window system. Note that this 

setting occurs in the . cshrc (or . profile) file in your home directory. Note 
also that the desktop program, described below, can easily change your default 
window system. 

New User; No Default If you are a new user but your account was not set up with the add_user pro- 

Window System gram or by copying the default . cshrc (or . profile) and . login files into 

your home directory, you will not have a default window system; you will have a 
shell prompt when you log in. 
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Old User; Previous Window If you are an old user logging in for the first time under this new operating sys- 
System tern, and you have re-installed the home directory you had been using before ins¬ 

tallation of the new operating system, you will have the same window system 
you previously had. 


With SunOS 4.1.2 you can change the window system invoked upon login by 
using the desktop ( 1 ) command. Note that this applies if you are using the 
default . cshrc file (from /usr/lib/Cshrc) and if you have modified the 
section of code regarding window-system invocation. 



An online tutorial, Introducing Your Sun Desktop, is provided in this release. 

The introduction is part of the default desktop and introduces you to some basic 
OpenWindows principles. It includes two short cookbook walkthroughs explain¬ 
ing how to copy, cut, and paste text, and how to use File Manager. Besides pro¬ 
viding you with some basic skill training, the introduction allows you to start 
some of the deskset utilities, test your SPARCstation’s audio capabilities, and 
select between German, French, and English versions of the introduction. 

You can access the online tutorial at any time when running OpenWindows by 
selecting it from the Workspace Programs menu. If you’d like to get spot help in 
French and German for the File Manager and Mail Tool, see page 36 of Introduc¬ 
ing Your Sun Desktop. 

3.7. OpenWindows Online This online tutorial provides instruction on all the basic skills necessary for 

Tutorial becoming a capable end-user of Sun Microsystems’ OpenWindows software. In 

addition to the easy-to-follow explanations, the tutorial offers demonstrations or 
simple animated examples of how the software works. 

The demonstrations are designed to display the software in detail and first-time 
users may find them especially helpful. Because the demonstrations’ animated 
scripts create a separate environment, you have to turn off system security in 
order to run them. 

You can, however, run the tutorial without accessing the demonstrations. This 
allows you to call up the tutorial for reference at anytime you are running 
OpenWindows and need a quick reminder. 

There are two ways to view the online tutorial: 

• With animated demonstrations 


3.6. Online Desktop 
Tutorial 


3.5. Changing the Window 
System to be Invoked 
upon Login 
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• Without the animated demonstrations 



The animated demonstrations run on Sun’s standard monochrome and color 
monitors (1152 X 900 pixels). They do not run correctly on the high resolution 
monitor (1600 X 1280 pixels). If you attempt to view an animated demonstration 
while mnning OpenWindows on a high-resolution monochrome monitor, an 
alert to this effect appears on the screen. 

You should also be aware that the demonstrations included with your online 
tutorial were designed to work using OpenWindows’ default settings. It is possi¬ 
ble to change these settings (as the online tutorial itself explains), but if you do, 
the animated demonstrations may not perform correctly. 



Do not move the mouse or press any mouse buttons or keyboard keys while 
a demonstration plays. This will interrupt the demonstration and can cause 
your system to crash. 


Accessing the Online Tutorial 
with Animated Demonstrations 


To access the online tutorial with animated demonstrations: 

1. Exit OpenWindows. 

To exit OpenWindows, press and hold the right mouse button anywhere in 
the background of your screen (wherever there is no window or icon). A 
Workspace menu appears. Still holding the right mouse button down, drag 
down, highlight Exit, and release the mouse button. 

2. At the % prompt on a full screen without windows, enter; 



The online tutorial appears on your screen with a Console window displayed 
nearby. Do not quit the Console window; it is there to accept system messages 
for you. 

Proceed to the tutorial section titled “Introduction-Read This First” for instruc¬ 
tions on using the online tutorial. To do this, click the left mouse button twice in 
rapid succession on the screen button marked “GoTo” beside the words 
“Introduction-Read This First.” 


Returning to OpenWindows To return to OpenWindows when you finish the online tutorial: 

1. Exit OpenWindows (as described in the previous section). 

2. At the prompt enter: 

fm.k^ . .. .. . . 

%/usr/openwin/bin/openwin 

^___ -. ..^. J 
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Accessing the Online Tutorial To access the online tutorial without animated demonstrations, from within 
without Animated OpenWindows enter: 

Demonstrations 

%/usr/ope»Lwin/dei&o/tutorial/tutorial, sh 

V..... . J 


An alert appears on screen: 


- 

Security is on. 

You must start server with either: 
openwin/demo/tutorial/start_tutorial 
openwin/bin/openwin -defeateventsecurity 

V_^_/ 


This is to remind you that security is on and animated demonstrations are not 
available. As long as you continue in the current mode (without demonstrations), 
a similar alert appears whenever you attempt to call up an animated demonstra¬ 
tion. 

We recommend that you operate the online tutorial without animated demonstra¬ 
tions whenever you want a quick refresher on OpenWindows features, tools, util¬ 
ities, or functions. 


Moving Around in the Tutorial When the tutorial comes up on your screen, the first thing you see is the Table of 

Contents. Next to each topic is a “GoTo” button. To learn about any topic or 
feature listed in the Table of Contents, position your mouse cursor over the GoTo 
button next to the topic you want and double-click using SELECT (the left 
mouse button). This takes you to the first page of the selected section of the 
tutorial. 


Closing the Tutorial When you are done with the tutorial, or if you want to take a break, you can close 

the online tutorial window to an icon on your screen. 

To close the online tutorial window, put your cursor in the border of the window. 
Press and hold MENU (right mouse button) and a pop-up window appears. Pull 
your cursor down to highlight the Close option and release the mouse button. 

The online tutorial is then suspended and a small icon appears on your monitor 
screen. 

There are two ways to reopen the online tutorial from its icon. You can 
double-click SELECT (left mouse button) on the icon and the online tutorial 
re-opens for use. You can also press and hold the right mouse button (MENU) 
over the icon; when the menu appears, highlight the Open option and release the 
mouse button. 
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Quitting the Online Tutorial Instead of closing the online tutorial, you can quit and exit the application 

entirely. To quit the online tutorial, position your cursor either in the tutorial 
window border or over the tutorial icon. Call up the window menu by pressing 
and holding MENU (right mouse button) and then highlight the Quit option. The 
tutorial window (or the icon) then disappears from the screen. 
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New Hardware Features 

SunOS 4.1.2 includes kernel or device support for the following new hardware 
products and features: 

• 1.3GB SCSI disk drive 

• GT graphics accelerator (Sun-4c) 

• GS graphics accelerator (Sun-4c) 

• GXplus graphics accelerator (Sun-4c) 

• TC-compatible frame buffer (Sun-4c) 

• VX graphics accelerator (Sun-4) 

• Support for SPARCsystem 600MP series systems, including: 

- Up to five SCSI buses 

- Open boot PROM support 

- Sbus and Mbus expansion buses 

- Improved network connections 

- Various enclosure configurations 

- CPU board bus and port options 

- CPU board memory options 

- Monitor options 

- Printer interface options 

- single-slot GX graphics accelerator 

- MCI frame buffer 

4.1. Peripheral Support SunOS 4.1.2 adds support for the new 1.3GB, 5 1/4-inch SCSI disk drive, a high- 

performance drive that incorporates Zone Bit Recording (ZBR), a method of 
recording that divides the surface of the disk into different zones, each with a dif¬ 
ferent number of bytes per track. This keeps the bit density constant across the 
surface of the disk, thus achieving higher performance and capacity. 


♦sun 

Xr microsystems 


Revision A of December 1991 






4-2 SunOS 4.1.2 Release Manual 


Note that the patch release titled 1.3 GB Disk Drive Enhancement, for supporting 
this drive under SunOS 4.1 and SunOS 4.1.1, is not required; the part numbers 
for this patch were: 

704-2948-11 (CD-ROM) 

700-2948-11 (tape) 

4.2. Graphics Support SunOS 4.1.2 also incorporates all functionality and fixes from the 4.1.1-GFX 

Rev.l and 4.1.1-GFX Rev.2 releases. This includes Sun-4c support for the GS, 
GT, and GXplus graphics accelerator boards and the TC-compatible frame 
buffer, Sun-4 support for the VX graphics accelerator board, and Sun-4m support 
for the single-slot GX graphics accelerator. All of these graphics devices except 
for the VX graphics accelerator were previously supported via GFX or other 
feature releases; the VX graphics accelerator was an unbundled device. 

GXplus Graphics Accelerator The GXplus is a memory enhanced version of the familiar double-wide Sbus GX 

card (also known as a eg6). It has four Mbytes of video RAM compared to one 
Mbyte on the standard GX. This enables the GXplus to support double buffering 
for smoother dynamic graphics, and fast retained windows for speedy damage 
repair. It also supports 1280 x 1024 resolution. GXplus is 100% backward- 
compatible with GX application software. 

GS Graphics Accelerator The GS is an integrated frame buffer and graphics accelerator that features 24-bit 

true color, accelerates the rendering of 3D solids, and also accelerates window 
system performance; it is also known as a cgl2 . Additional features include: 

• 24-bit double buffering (transparently dithered by hardware to 12-bit) 

• 16-bit Z-buffer 

• Gouraud shading using up to 8 colored light sources simultaneously 

• Hardware picking and BitBlt 

• Support for 76 Hz. monitor 

• Separate cursor planes (in OpenWindows Version 3) 

• Multiple rendering modes, allowing 1-bit, 8-bit, and 24-bit applications to be 
run and displayed simultaneously 

• Support for SunView software application programmer interfaces (APIs), 
including Pixwin (but not Pixrects), and SunPHIGS 1.2, 1.3, 1.4, and later 

• Support for OpenWindows Version 3 software application programmer 
interfaces (APIs) and toolkits, including SunPHIGS 2.0, XGL 2.0, GKS 4.1, 
XView, OUT, TNT, and Xlib 

The SunView window system is fully supported by the GS. OpenWindows Ver¬ 
sion 2 runs on the GS in monochrome overlay only. OpenWindows Version 3 on 
the GS supports visuals in 4-bit, 8-bit, and 24-bit plane groups. 
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GT Graphics Accelerator The SPARCstation GT is a high-performance 24-bit true color graphics accelera¬ 

tor that provides high-quality advanced 2D and 3D accelerated graphics features. 
Features include: 

• 8-bit and 24-bit double buffering 

• 24-bit Z-buffer 

• 8-bit double-buffered overlays 

• 10 window ID planes 

• four double-buffered, fast clear planes 

• Separate cursor planes (in OpenWindows Version 3) 

• Line, polygon, and stroke text anti-aliasing 

• Support for OpenWindows Version 3 software application programmer 
interfaces (APIs) and toolkits, including SunPHIGS 2.0, XGL 2.0, GKS 4.1, 
XView, OLIT, TNT, and Xlib 

The SunView window system is fully supported by the GT. OpenWindows 
Version 2 runs on the GT in monochrome overlay only. OpenWindows Ver¬ 
sion 3 on the GT supports visuals in 8-bit and 24-bit plane groups. 

VX Graphics Accelerator The VX is one of Sun’s second generation visualization acceleratorsf or Sun 

SPARCsystems. The VX, a successor to the TAAC-1, includes a high perfor¬ 
mance, floating point processor, alb MByte frame buffer, and a GX-accelerated 
system frame buffer. 

TC-Compatible Frame Buffer The TC is a basic "dumb" 24-bit true color frame buffer with an additional 2-bit 

overlay/enable plane group; it is also known as a cg8. 

Under SunView, the TC supports 1-bit, 8-bit, and 24-bit plane groups. The user 
is cautioned that the 8-bit support is achieved by software simulation of an 8-bit 
mode within the 24-bit plane group; 8-bit performance is less than that found 
with a typical 8-bit frame buffer. 

Under OpenWindows Version 3, the TC supports 1-bit and 24-bit visuals, with 
no 8-bit support. The 1-bit plane group is the default visual; if you wish, you can 
specify the 24-bit TrueColor to be the default visual at the time you start 
OpenWindows. See the OpenWindows Programmer’s Guide for more informa¬ 
tion. 

SunOS 4.1.2 supports SPARCsystem 600MP series systems. SPARCsystem 
600MP series systems, which are available in two and four processor 
configurations, offer multiprocessing to improve compute performance, plus net¬ 
work and I/O enhancements that improve server performance. Multiprocessing 
provides scalable CPU performance that can cover a wide range of customer 
needs and significantly extend the top system performance beyond existing Sun 
systems. All 600MP series systems use a tightly-coupled, shared memory mul¬ 
tiprocessing mode and high-bandwidth MBus for the primary connection 
between the CPUs and memory. The processors are located on module cards that 
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Support for Multiple SCSI 
Buses on SPARCsystem 
600MP 


Open Boot PROM 


Sbus and Mbus Expansion 
Buses 


Improved Network 
Connections 


Enclosure Configurations 


CPU Board Bus and Port 
Options 


plug into MBus connectors on the CPU board, offering easy upgrading to addi¬ 
tional processors or future SPARC technology. 

The SunOS 4.1.2 generic sun4m kernel configuration file declares support for 
five SCSI buses and the devices that can be connected to them. The 
GENERIC_SMALL kernel configuration file declares two SCSI buses and the dev¬ 
ices that go with them. 

The open boot PROM supports booting of a SPARCsystem 600MP series system. 
In most standard configurations, when you install SBE/S cards on the CPU board 
the devices are recognized automatically. If you have a non-standard 
configuration, you need to reconfigure the kernel. See Chapter 5, “Open Boot 
PROM 2.0 and Hierarchical Device Naming” for detailed information about the 
open boot PROM and how to boot a SPARCsystem. 

Two different expansion buses provide the benefit of Sun’s latest technical inno¬ 
vations while linking the system to established Sun products. The 600MP series 
systems are the first large server systems to use the SBus, which is the primary 
I/O bus for system services and expansion. SBus offers much higher I/O perfor¬ 
mance and uses low-cost CMOS technology for a variety of add-on options such 
as disk controllers and network interfaces. But, because 600MP series systems 
were designed to support VME boards, you can continue to use most of your 
VME bus options in Sun’s servers. 

For networking, 600MP series systems offer an on-board buffered Ethernet con¬ 
nection (the SBus SCSI/Buffered Ethernet Card — also called the SBE/S card) 
that can handle bursts of packets from high-speed client workstations better than 
a non-buffered connection, improving responsiveness and reducing network and 
server loading. Also supported is the new SBus FDDI and token ring options, 
which offer you tremendous flexibility in your choice of LAN technology. 

Note that up to five Ethernets can now be supported on a SPARCsystem 600MP 
series system — one on the CPU board and one each on the four SBE/S cards. 

The 600MP series systems are packaged in one of three enclosures: the 5-Slot 
Office Pedestal (630MP), the 12-Slot Office Pedestal (670MP), or the 56-inch 
Data Center Cabinet (690MP). See the appropriate hardware manuals for details. 

The Sun 600MP CPU board operates at 40 MHz. The CPU board can have one 
MBus module (two processors) and four Sbus expansion slots or two Mbus 
modules (four processors) and three Sbus expansion slots. 

The Sun 600MP CPU board also has the following ports: 

• two RS232/RS423 synchronous serial ports 

• Ethernet port 

• SCSI port 
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• keyboard/mouse port 

• scan port for remote diagnostic service processor 

• audio port (SPARCstation 1-style audio) 

CPU Board Memory Options The memory on the Sun 600MP CPU board can be expanded in 16 or 64 MB 

SIMM increments to a maximum of 128 MB. The CPU board has 32 SIMM slots 
in two banks of 16. The following SIMM sets are available for insertion in these 
slots: 

• 16 MB ECC Memory Expansion SIMMs (1 MB SIMMs) 

• 64 MB ECC Memory Expansion SIMMs (4 MB SIMMs) 

Monitor Options The 600MP series systems are normally configured as networked servers. Custo¬ 

mers can add a display monitor to use as console or to create a workstation 
configuration. 

Graphics Support The only supported graphics device for the SPARCsystem 600MP series are the 

single-slot GX graphics accelerator and the MGl frame buffer. 


Printer Interface Options The 600MP series systems offer both serial and parallel interfaces. The serial 

interface is on the CPU board. The SBus parallel interface for the SPARCprinter 
is the parallel laser printer card. 

4.4. Related SPARCsystem The following documents contain additional information about the 
600MP Documents SPARCsystem 600MP series systems. 

Document Part Number 

SPARCsystem 630MP Installation Manual 800-5937 

SPARCsystem 670MP Installation Manual 800-5904 

SPARCsystem 690MP Installation Manual 800-5935 

600MP CPU and Memory Board Installation & Service Manual 800-5318 
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Open Boot PROM 2.0 and Hierarchical 

Device Naming 


This chapter provides information about open boot PROM 2.0 and hierarchical 
device naming on all machines with open boot PROM 2.0 (SPARCstation 2, 
SPARCstation IPX, SPARCstation ELC, all SPARCsystem 600MP systems, and 
some SPARCstation IPCs). 

Most users, once release software has been installed from tape or CD-ROM, only 
need to boot from their default boot source and never have to be concerned with 
either boot device aliases or hierarchical device names. For such users, the only 
times it is necessary to boot are when their machine has been turned off, in which 
case turning it on again causes it to reboot automatically, or when their system 
has crashed or frozen. In this case, turning the machine off and then on again 
automatically reboots from the default source. 

The user of a desktop SPARCsystem who accidentally arrives at the PROM Moni¬ 
tor prompt by pressing ( Ll/Stop I - fal or otherwise interrupting the system, can 
simply follow the screen prompt that is displayed in this situation and enter either 
go, at the ok prompt, or c, at the > prompt, in order to continue. 

The only case in which it is necessary to enter a device name is when booting is 
to be from a non-default device. For many users who reach this point, the non¬ 
default device is a standard device for which there is a predefined alias (described 
below). 

Prior to SunOS 4.1.1 and the SPARCstation 2, a disk controller purchased from 
manufacturers other than Sun could not be used for booting unless the manufac¬ 
turer specifically designed the controller to work under a Sun boot PROM, or 
received code from Sun that could be incorporated in the controller. The open 
boot PROM and new conventions for hierarchical device naming now make it pos¬ 
sible for a Sun Desktop SPARCsystem or a SPARCsystem 600MP system to 
boot from disk controllers that have not been specifically coordinated with Sun 
specifications. 

5.1. Built-in Aliases for 
Standard Devices 


All open boot PROM 2.0 systems have a set of predefined aliases for standard dev¬ 
ice names. These are adequate in the great majority of situations. The only time 
it should be necessary to go beyond these aliases is when you are using a newly 
configured type of device to boot from or when you are booting from a 
non-standard source. 
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Switching from Restricted There are two operational monitors available with open boot PROM 2.0 systems: 

Monitor to Forth Monitor the restricted monitor, which uses the > prompt, and the Forth monitor, which 

uses the ok prompt. You can do simple booting procedures from either prompt, 
but you need to be in the Forth monitor to perform more complex functions. 

See the Open Boot 2.0 Command Reference manual (Part Number 800-6076-10) 
for detailed instructions for using the open boot PROM. 


To switch from the > prompt to the Forth prompt, type n (for new-mode): 


/ - 

s 

> n 


ok 


V 

J 


To switch from the ok prompt to the restricted prompt, type old-mode: 


f 

A 

ok old-mode 


> 



J 


Booting Open Boot PROM 2.0 
Systems from the CPU (except 
690MP) 


The table below shows a sample of the bootpaths that are required for booting a 
system with Open Boot PROM 2.0 and higher. To boot with one of the 
predefined aliases, type boot and the appropriate alias from the ok prompt or 
type b and the appropriate alias from the > prompt. Note that the SPARCsystem 
690MP, which has IPI disks, has a different set of aliases for booting from disk. 


Table 5-1 Booting an Open Boot PROM 2.0 System from the CPU 



PROM Monitor Aliases for Device Path Names 

Open Boot 
Alias 

Full Device Path 

Boot From: 


/iommu/sbus/dma @ f,81000/esp @ f,80000/sd @3,0 

Default disk (1st onboard) 


/iommu/sbus/dma @ f,81000/esp @ f,80000/ sd @ 3,0 

First onboard disk 


/iommu/sbus/dma @ f,81000/esp @ f,80000/sd @1,0 

Second onboard disk 


/iommu/sbus/dma @ f,81000/esp @ f,80000/ sd @ 2,0 

First external disk 


/iommu/sbus/dma @ f,81000/esp @ f,80000/sd @0,0 

Second external disk 

tape 

/iommu/sbus/dma @ f,81000/esp @ f,80000/st @4,0 

Default tape drive (first) 

tapeO 

/iommu/sbus/dma @ f,81000/esp @ f,80000/st @4,0 

First tape drive 

tapel 

/iommu/sbus/dma @ f,81000/esp @ f,80000/st @5,0 

Second tape drive 

cdroma 

/iommu/sbus/dma @ f,81000/esp @ f,80000/sr @ 6,0:a 

CD-ROM partition a 

cdrom 

/iommu/sbus/dma @ f,81000/esp @ f,80000/sr @ 6,0: d 

CD-ROM partition d(MUNIX) 

net 

/iommu/sbus/lebuffer @ f,40000/le @ f,60000 

Default Ethernet 
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Booting a SPARCsystem 690MP from the CPU 

The table below shows a sample of the bootpaths that are required for booting a SPARCsystem 690MP with Open 
Boot PROM 2.0 and higher. 


Table 5-2 Booting a SPARCsystem 690MP from the CPU with Open Boot PROM 2.0 



PROM Monitor Aliases for Device Path Names 

Open Boot 
Alias 

Full Device Path 

Boot From: 

ipi 

/iommu/vme/idc @ 4d, 1080000/id @0,0 

Default disk (first) 

ipiO 

/iommu/vme/idc @4d, 1080000/id @0,0 

First disk drive 

ipil 

/iommu/vme/idc @ 4d, 1080000/id @1,0 

Second disk drive 

ipi2 

/iommu/vme/idc @ 4d, 1080000/id @2,0 

Third disk drive 

ipi3 

/iommu/vme/idc @ 4d, 1080000/id @3,0 

Fourth disk drive 

ipi4 

/iommu/vme/idc @ 4d, 1080000/id @4,0 

Fifth disk drive 

ipi5 

/iommu/vme/idc @ 4d, 1080000/id @5,0 

Sixth disk drive 

ipi6 

/iommu/vme/idc @ 4d, 1080000/id @6,0 

Seventh disk drive 

ipiV 

/iommu/vme/idc@4d,1080000/id@7,0 

Eighth disk drive 

tape 

/iommu/sbus/dma @ f,81000/esp @ f,80000/st @4,0 

Default tape drive (firstO 


/iommu/ sbus/dma @ f,81000/esp @ f,80000/st @4,0 

First tape drive 

tapel 

/iommu/sbus/dma @ f,81000/esp @ f,80000/st @ 5,0 

Second tape drive 

cdroma 

/iommu/sbus/dma @ f,81000/esp @ f,80000/sr @ 6,0: a 

CD-ROM partition a 

cdrom 

/iommu/sbus/dma @ f,81000/esp @f,80000/sr @ 6,0:d 

CD-ROM partition d(MUNIX) 

net 

-1 

/iommu/sbus/lebuffer @ f,40000/le @ f ,60000 

Default Ethernet 


Changing Default Boot Device To change the default boot device, you need to execute the set-defaults 

command to make sure every NVRAM parameter is in its default state, and set the 
default boot device on the open boot PROM. 

1. At the ok prompt, execute set-defaults: 

ok set-defaults 

Setting nvram parameters to default values, 
ok 

V_ 

This command can be used to restore the NVRAM to a known state. Nor¬ 
mally, executing this command once before or during the OS installation 
will be enough, but it could be used any time to get back to the ‘factory’ 
defaults of the NVRAM parameters. 


2. Set the default boot device; for instance, to designate the first IPI disk as the 
boot device, do the following: 


/ 


ok setenv boot-device ipiO 


ok 


V 

J 
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This will ensure that the system will boot up without any user interaction 
after a power-on, for instance. If the OS is installed on the first disk (ID 0) 
of the first IPI controller, the boot device name is ipi or ipi 0, as shown in 
the above example. 


Optionally, the NVRAM parameter diag-device, which is used if the sys¬ 
tem is in DIAG mode, could be set to be the same as boot -device with 
the following command: 


c 

-\ 

ok setenev diag-device ipiO 


V 



With this setting, auto boot will work even if someone hits the DIAG switch 
by mistake. 


Devices are attached to a system on buses, with a device at one end of a bus con¬ 
trolling devices at the other end. This establishes a hierarchy of devices that can 
be represented as a tree of nodes, with each device a node and the system itself 
the top node. In hierarchical device naming, the name of a device is given as the 
path from the top of the device tree to the device itself. 

Hierarchical device naming makes it possible to specify new device parameters 
not previously contained in a CPU’s NVRAM for accessing disk devices. For 
example, to specify the system bus, bus adapter, and controller to be used by a 
new disk, one might want to specify a hierarchy such as: 

/ sbus / vme / [new controller type^inew disk type] 

Rules for specifying hierarchical device names are given in “Device Naming 
Conventions,” below. All open boot device names must initially be entered as 
complete pathname hierarchies. 

Hierarchical device names can be long and complicated; entering a full hierarchi¬ 
cal device every time one wanted to execute a conunand to boot would be a tedi¬ 
ous and error prone process. To simplify commands, the open boot PROM pro¬ 
vides a set of predefined one-word aliases for standard devices and allows you to 
define an alias of your own for any hierarchical device name. For the great 
majority of users, no specific knowledge of hierarchical device naming will ever 
be necessary in order to operate their system. 

5.3. Device Naming A hierarchical device name is specified by giving a path from the top node of the 

Conventions device tree to the device itself. Each node on the device path is marked by a 

slash (“/”). An example of a device-name path is: 

/sbus@l,f8000000/esp@0,800000/sd@3,0:b 

The first represents the highest node, the workstation itself. Connected to it is 
an SBus at the address/SOdOdOO. The next node is the SBus itself. At the first 
slot on the SBus (“@0” ), with an address offset of 800000, is an esp SCSI host 
adapter. A SCSI disk (sd) is connected to the esp SCSI host adapter as logical 
unit 1 (0) at target 3 (this corresponds to UNIX device name sdO). Finally, the 


5.2. Hierarchical Device 
Naming 
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element after the is a device-specific parameter. In this case, it identifies par¬ 
tition b of disk sdO, which might be used in booting the miniroot during instal¬ 
lation. 

The devices in a device tree are identified by node names consisting of: 

driver-name @ unit-addresses .’device-parameters 

sbus@l,f8000000 is a node name in the device-name path above. 1 and 
fSOOOOOO are unit addresses for the SBus. No SBus device parameters are 
specified. 

A driver-name can be made up of letters, digits, and the special characters 
“-h,” which are treated as letters. Upper and lower case are distinct; length 
can be from 1 to 31 characters, sbus and esp are driver names. 

@ unit-addresses is optional. If specified, there can be one or more unit 
addresses. A unit-address can be made up of letters and digits. It can be arbi¬ 
trarily long, although sequences of more than eight characters are discouraged. 

.’device parameters is optional. If specified, there can be one or more device 
parameters. A device parameter can be made up of letters and digits. It can be 
arbitrarily long, although sequences of more than eight characters are 
discouraged. 


5.4. Using show-devs From the PROM Monitor prompt, you can use the show-devs command to 

Command to Display display the devices known to a system: 

Device Names _ 




ok show-devs driver-name 


V 

y 


- driver-name is optional; when used, show-devs only displays device 
paths descending from the node identified by the entry. 


- 

ok show-devs 

/options 
/fd@l,f7200000 
/ttyb 
/tty a 
/keyboard 


/sbus@l,f8000000/esp@0,800000/sd 
/sbus@l,f8000000/esp@0,800000/st 
/packages/deblocker 
/packages/sun-label 

V_____ ) 


Note: Sample display; contents may vary, depending on user input and the system used. 
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f -^ 

ok show-devs /sbus 

/sbus@l,£8000000/le@0,c00000 
/sbus@l,£8000000/dmaOO,400000 
/sbusOl,£8000000/esp@0,800000 
/sbusOl,£8000000/esp@0,800000/st 
/sbusOl,£8000000/esp@0,800000/sd 

V_ J 


Note: Sample display; contents may vary, depending on user input and the system used. 


The devalias command allows you to list all device name aliases currently 
defined and to define additional aliases. The new aliases are maintained in sys¬ 
tem memory; they are not kept in NVRAM and need to be re-entered whenever 
your system reboots or is shut down. 

Used alone, devalias lists aliases: 





ok devalias 

disk 

/sbus@l,£8000000/esp@0,£800000/sd 


tape 

/sbusOl,£8000000/esp@0,£800000/st 


net 

/sbus@l,£8000000/le@0,£800000 


V 


J 


Note: Sample display; contents may vary, depending on user input and the system used. 

To define a new device path name alias, use devalias with an alias 
specification: 

- —_ ^ _ _ ■■■ ■ ■V .■ ' n 

ok alias device-path 

\ _ ^ _ : _ : _ ^ ___-___ 

A number of environment parameters that control essential open boot prom mon¬ 
itor functions are stored in NVRAM. These parameters can be examined, 
modified, and reset to factory defaults with the pr int env, set env, set - 
default and set-defaults commands. 


5.6. Open Boot PROM 
Environment 
Parameters Stored in 
NVRAM 


5.5. Using devalias 

Command to Show and 
Define Device Aliases 


print env Command Used in the form 

print env environment-parameter 

print env displays the current value of the specified environment parameter 
and its original factory default value. 

Used alone, without specifying an environment parameter, print env displays 
all current values for NVRAM environment variables and their original factory 
default values: 
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setenv Command 


set-default and set- 
defaults Commands 


-^ 


ok printenv 

Parameter Name 

Value 

Default Value 

name 

options 

options 

oem-logo 

oem-logo? 

false 

false 

oem-banner 

oem-banner? 

false 

false 

sbus-probe-list 

0123 

0123 

output-device 

screen 

screen 

input-device 

keyboard 

keyboard 

keyboard-click? 

false 

false 

keymap 
diag-file 
diag-device 

net 

net 

boot-file 

boot-device 

disk 

disk 

auto-boot? 

false 

true 

v^atchdog-reboot ? 

false 

false 

fcode-debug? 

false 

false 

screen-#columns 

80 

80 

screen-#rows 

34 

34 

sunmon-compat ? 

false 

true 

diag-switch? 

false 

true 


^_ J 


Use setenv followed by the name of an environment parameter and a value to 
enter a new parameter value. For example, to change the current value of the 
parameter boot-device so that a client system default boots from its server, 
you would enter: 


( ^ 

ok setenv boot-device net 

V_y 


The command set-defaults resets most parameters to their factory default 
values. The command set-default followed by the name of an environment 
parameter resets the specified parameter to its factory default value. 
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Bugs Fixed in SunOS 4.1.2 


Over 200 bugs have been fixed for SunOS 4.1.2. This chapter lists the more significant fixes, including CTE patches 
included in SunOS 4.1.2 (see Section 6.13). The bugs are listed in categories, and include the bug ID and a synopsis 
of the bug. The following categories are included: 

• Kernel 

• Network 

• SCSI 

• Graphics 

• Utility 

• Library 

• Libsuntool 

• Sunview 

• Compiler/Loader 

• C2 

• Documentation 

• Install 

• CTE Escalations 

• CTE OpenWindows Version 2 Patches 


6.1. Kernel 

1008324 TIOCCONS is a security hole 
1016767 /boot works for 1st disk controller only 

1029802 4/280 with xy451 panics: regs accessed while busy (patchid 100364-01) 

1032053 getreg should use fuword() when simulating instructions 

1032534 Kernel panics with panic: psig on exiting sunview 

1033861 Request an intelligent swap block freeing algorithm 

1036167 modified superblock may not be updated at unmount 

1036196 MLOCK/MUNLOCK broken 

1036449 modified superblock may not be updated at unmount 
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1037039 ufs_readdir hangs on a Olen entry 

1037052 shmdt(2) will not detach a read only segment 

1037715 ISO orderly release is not supported, but TCPTLI says so 

1038651 Using tmpfs ie ram /tmp can cause data initlztn w Fortran on 4.1 

1038686 System panics with "panic: hat_ptesync - invalid pme" message 

1039275 writing to an PROT_READ area is giving SIGBUS not SIGSEGV 

1039287 tcp/tli transport cannot send more than 4052 bytes of data 

1039410 putting default swap partition in fstab causes system crash, dump 

1039840 unmount doesn’t close block device 

1039846 unmount leaves metadata cached 

1039850 inode left locked on symlink creation 

1040722 Pseudo-ttys become attached to other users or hang 

1042350 tmpfs problem with ftruncate test in SCTS from SUNVS 

1042808 nopagereclaim erroneously set to 1 for Sun-4/4xx 

1043270 tmpfs disallows mmap beyond end of file 

1043801 panic: assertion failed, pmg->pmg_keepcnt == 1 

1044192 hard link to a directory succeeds on tmpfs for non-root users 

1044666 panic: ttcompat: unexpected ioctl acknowledgment 

1044668 umount/sync race can hang system 

1044888 Streams run out of dblks and hung the system 

1045360 spurious VME intrrpts cause kernel to panic: data f 

1045582 Newsprint 1.0 hangs on 4/75 and 4/40 

1046449 multiple-register sbus cards don’t work on a 4/75 

1047295 mounting certain iso 9660 cd’s succeed but directory becomes data 

1047355 polling not working correctly 

1047586 mkfifo does not work on tmpfs 

1048128 xon flow control problems on serial i/o 

1049010 DLS60 kernel config file is incorrect. 

1049027 tmpfs hangs and deadlocks 

1049125 System panic’s when reject a network connection via TLI 

1050340 mmap(MAP_PRIVATE), madvise(MADV_SEQUENTIAL) => panic: swap_xlate 

1050540 mount and sync can deadlock and hang the box 

1050543 umount can cause a iinactive panic 

1050546 putpage can hang the box 

1050548 nfs_putpage can hang the box 

1050558 Sparcstation 2 running SunOS 4.1.1 crashes under some applications 

1051875 mkfs can create an unusable file system 

1051876 system hangs when pageout sleeps in ufs_putpage 

1051983 buffer cache sz decreases w Ig kernels causing high (patch 100330-02) 

1051992 pageout and clustering are not cooperating 

1052649 write system call is returning EINTR 

1052669 panic: data fault in strwrite - streams corruption 

1053582 mount/sync window causes panic: sleep 

1054054 +s and -i-t together do not work as expected 

1054999 syncip overhead in ufs_inactive causes poor NFS performance 

1056058 panic when writing to a >=2g-bsize file 

1056245 Process hangs in page_cv_wait, ufs_getapage after locking page 

1056992 4.1.1 leaks kernelmap 

1056992 4.1.1 leaks kernelmap (patch 100330-02) 
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1057211 VME master bus accesses can time out during heavy I/O 
1057478 access to non-existn mmap /dev/sbus cause panic: async memory err 
1057481 System hangs when running TLI 

1057929 sys hang: prestosrve and NC400 exhausting kernelmap (patch 100330-02) 

1057963 cannot mount an exported tmpfs directory 

1060281 polio sys call gives bad returns for fd events 

1061174 poll does not return -1 when it receives a signal 

1063310 floppy driver reports drive as "unexpectedly busy" 

1065858 Cant run OW xinit on 4/670, 4/630 running 412A1.2 

1066086 4.1.2 kernel crashes under async I/O load, running MP 

1066422 performance enhancements for the sun4m IPI driver 

1066743 Track crosscall stats separately from intrrpt stats 

1067681 lockf s signal behavior may break applications 

1068051 profiling kernel support for sun4m 

1068283 vmstat reports incorrect numbers 

1068363 system crashes with 112mb memory and 128 maxusers 

1068462 kernel workaround needed for bugid 1067719 

1068548 PROM mailbox not properly mapped 

1068907 remove CDROM driver debug info 

1068910 Dump of data using /dev/ sbus* device files broken 

1069072 Int div on spare can be used to modify data 

1070099 support for removable disks got busted in 4.1.1 

6.2. Network 


1006905 add lock file to render rpc.yppasswdd single threaded 
1034328 client can crash if two procs unlink (patchid 100173-06) 

1038060 ieO: WARNING: if_snd full error still noted 

1039326 vmunix : ieO : lost interrupt: resetting 

1041303 ifeonfO off by one 

1045211 Problem with booting diskless clients 

1045531 Lock Mgr. suspends "file locking" processes indefinitely 

1045536 nfs exprts to non-sun sys can result (patchid 100173-06) 

1064433 Export of subtree doesn’t work (patchid 100173-06) 

1066287 nfs hang when looking at Ig file changed on server (patchid 100173-06) 
1066663 SIGIO signal for async io fails to pend across NFS (patchid 100357-01) 
1029628 setuid bit copied to NFS file system 

1030884 NFS full file sys gets ENOSPC even when overwriting existing file 

1034328 client can crash if two proc’s unlink the same file at once 

1034750 automount hangs while trying to open a mount point 

1037476 Sending bad proc to NFS server can cause mbuf leak 

1038302 NFS export option "anon=-l" does not work 

1038308 4.1 automount sets up a different sym link 5 mins after 1st access 

1039406 3960-3980th repeated sekt open & close fails w addr already in use 

1039839 nres_gethostbyaddr logs erroneous messages to NIS server’s console 

1039977 bug in the NFS DEBUG code, file nfs_export.c 

1041409 cannot execute setuid root programs in NFS mounted filesystem 

1041559 system is panicing in mclput 

1042435 client side noninterruptible hang 

^sun 

XT microsystems 


Revision A of December 1991 



6-4 SunOS 4.1.2 Release Manual 


1043343 

1044565 

1045536 

1045700 

1045993 

1045995 

1045996 

1046001 

1046945 

1047557 

1048875 

1052330 

1052879 

1053552 

1053679 

1054669 

1057673 

1057685 

1057878 


increase arp table size 

pc-nfs client failed locking entire UNIX file 

NFS exports to non-sun systems can result in file truncation 

lockf fails when two processes try to read, write simultaneously 

NFS file caching still occuring on locked files 

unlink(2) on a file will prevent NFS file locks on the same file 

File locks are not removed on the server when a client is rebooted 

fcntl is interupted by signals and returns the wrong error code 

’ping’ caused machine to panic 

Old pages not being purged if file gets truncated on server 
Missing /etc/mtab file can fork the automounter 
locking on NFS file doesn’t cause cache purged after the 1st time 
panic iesynccmd with SunNet OSI 7.0 

ip_input drops pckts w IP opts as bad checksum w mclput pnc patch 

file region locking of NFS files was broken in 4.x 

telnetd allows password snooping 

panic: iinactive may result from klm code 

4.1.1 NFS servers freezing 

panic due to window in rtfree() 


6.3. SCSI 

1036481 bsr after reading EOF doesn’t record space back, wrong pstn stat 
1042822 St: warning tape may be wearing.... on Exabytes 
1045071 sd: does not scan past 1 GB when using format utility 
1045586 Handling of special FORMAT command is broken w.r.t blkno decode 
1046305 some XXgetcap cases reversed 

1046580 bug in esp host adapter can cause panic during error recovery 

1048141 esp does not always recognize a marginal SCSI bus 

1049417 select phase not timed out causing indefinite hangs 

1049674 general bug report for some esp problems 

1049830 timeouts in polled mode cause a panic 

1050067 esp driver resource alloc fails when esp is child if dma 

1051244 SCSI Tape drive is misusing signals 

1052613 max dma limits set by host adapters are too small 

1052659 FSR on the old SCSI tape driver fails in 4.1.1 

1052888 St driver can cause a panic: zero divide trap 

1055184 3/2 sundev/sd.c uses only one buffer per unit 

1058682 Reassign block (format "repair") malfunctions beyond 1GB 

1059139 Accessing a SCSI tape drive causes system crash 

1062430 St drvr writes extra file mrks if opened then closed after writing 

1065300 front load tape doesn’t reliably read tapes 

1067300 St: soft errors sometimes cause loss of data 

1070535 esp: sync xfer rate is not renegotiated 

1070540 esp: incomplt cleanup after proxy msg causes panic 

1070876 delay after scsi bus reset required 

[various] improvements in st ioctl, EOF, EOT, EOM handling & status rprt 
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6.4. Graphics 

1045577 rasfilter_rgbtobgr always fails 

1046046 The colormap is not correct when 128 colors are used on 4.1.1 

1046327 P4 CG6 hardware cursor invisible under Sunwindows on OS4.1.1 

1063738 Diffuse positional lights on color-per-vertex tri 

1063743 Ambient positional lights for color-per-vertex 

1064295 Degenerate hollow triangles cause internal edge 

1066677 GT crashes w SunPHIGS Quick Update of batched polyl 

1066772 wide patterned polylines without vertex colours are 

1066851 gtconf ig -M flag doesn’t preserve VIDEO_ENABLE 

1066983 quick check pgm to visually test accel port to dev 

1067972 hi res version of eg 12 (gsxr) text is trash in pr_b 

1068136 gtconf ig needs sync generator setup pgms for NTSC 

1068153 Leaf nodes which set no attributes cause QUM mode 

1068802 pixwin double buffer bug for GS 

1069396 gtconfig: sync generator pgm change needed for 

1069691 phigsehild crashes GT system when huge application 

1070466 Setting hatch_transparency to false affects perf 

1071971 Get jitter when using 1280 @ 67hz video output forma 

6.5. Utility 

1016437 Ipd does not check file names for legality 

1022363 format: remove dummy defect list commit for embedded SCSI disks 
1025250 Zero-lngth defect list causes format to fail extractn of mnfe... 

1030087 sendmail yp aliasing does not work with non-sun yp masters 
1031577 modload does not recognize the "vector" keyword 
1035625 not enough information on embedded scsi defect lists 
1036159 A user can run programs with root’s group privileges... 

1039221 bar core dumps w -x or -t option 

1045185 Disks are displayed in controller order but chosen in disk order 
1045636 4.1 /bin/mail problem delivering mail 
1047340 /bin/mail can be used to invoke a root shell 
1049010 DLS60 config file does not work 

1050675 Original, extract format command fails if defect count is zero 
1051638 format mode selects don’t support SCSI-2 page format 
1052805 Low-level format of MD21 disks usually fail with Warning... 

1053733 pax gets into infinite loop at EOT 

1055402 Bourne shell scripts using inline redirection and 

1058003 When reading from /dev/printer Ipd does not check how much data it has read 
1058236 checksum error even with -c -i options 

1059212 Improvement needed in mode select error handling for SCSI disks 

1059225 Do not hardwire any SCSI disk mode select parameters 

1063772 possible to overwrite a file on system using Ipr 

1067216 Format fails on 207mb maxtor drive 

1068402 mkf s should initialize UFS clean flag 

1068640 formatting CDC drives generates errors 
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6.6. Library 

1038500 localtime or tzsetwall corrupts malloc space (libc) 

1041074 The disk version of the "C" locale is incomplete 
1044722 undefined symbol in libxpg.a 

1044909 /usr/lib/expreserve race condition was used to break into a system 

1045471 4.1(-i-) shared C libraries reference undefined symbols 

1050040 fcvt() segment faults under 4.1.1 

1051619 systemO uses the system call fork() instead of vfor 

1051881 colldef rejects apparently valid input 

1052398 strxfrm is not 8 bit clean 

1052463 colldef can’t handle a substitute statement with hex numbers 
1053346 There shouldnt be an imposed length limit for strings in strcoll() 

6.7. Libsuntool 

1038363 window_destroy does not release memory; 8k memory leak per textsw 

6.8. Sunview 

1028856 2/2 master defaults database is not being read 
1038313 1/1 Can’t open and use more than 64 windows concurrently 
1039576 1/1 selection_svc and rpc can be used to gain access to system files 
1039760 3/2 notifier fails to handle fcntl for FNDELAY correctly 
1040606 2/3 selection_svc security problem 

6.9. Compiler/Loader 

NOTE: new compiler/loader in SunOS 4.1.2 includes substantial fixes that may affect some application programs. 
See “Link-editor Bug Fixes” in Chapter 2 for more detail. 

1019004 -assert definitions can fail to report undefined symbols 

1032208 Idd doesn’t write file names if standard output is not a tty 

1032209 Idd runs out of file descriptors 

1032739 Id core dumps with many libs in mult, directories 

1033086 Calling dlopen() on a file with BSS kills your application 

1034788 -r and -pic do not mix bad secondary magic number on 4.1 

1034833 Id: can’t mixed -r with -Bstatic or -A flag in 4.1 

1034844 missing symbol from Id -r 4.1 object; exists in 4.0.3 Id output 

1037879 Cannot create executable w shared obj which points to another 

1042261 Id only recognizes first directory in LD_LIBRARY_PATH 

1043082 Bogus first arg to ’Idconfig’ kills dynamic linking 

1043300 dlclose prevents access to functions even after further dlopen 

1044524 multiply defined symbols and seg. fault caused by 4.1’s Id 

1045194 dlsym returns bad addr for uninit global var in dlopened library 

1045272 Id -u & -r dont seem to work properly 

1046379 cant call a fnctn in a shared lib from a fnctn in another ... 

1046462 Id fails with seg fault proc nested incl 

1050594 Uninitialized struct slot causes intermittent failures 

1052428 Id.so usage of -L options confusing, leads to security problems 

1064820 Id can produce bogus diags with cascaded 

1069404 bad handle errors with dlsym(dlopen(NULL,l),"xxx") 
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6.10. C2 

1040334 yppasswd wont allow user to change passwd from client..daemon dies 
1040465 The passwd -e command does not work when c2 security is in place 
1044204 rpc.passwdauthd can be used to guess passwords on c2 systems 
1047131 getauditflagscharO routine as distrib in 4.1 libc does not work 

6.11. Documentation 

1051880 colldef input format not documented 
1051882 semantics of colldef are unclear 

6.12. Install 

1041627 add_services can fail if partition changes are made after Suninstall. 

1047095 install from CD stops and complains if floppy is in 
1047696 Can’t boot 4.1.1 munix on a sun4c w/40mb of memory 
1063858 disk form takes 5 minutes to exit in a 40 disk machine 
1064779 dataless install corrupts file system 
1069645 should add support for key tables in munix 

6.13. CTE Escalations Fixed in SunOS 4.1.2 

Listed below are the Corporate Technical Escalations (CTE) patches which have been incorporated in SunOS 4.1.2. 
The list is in patch ID order and includes bug IDs and a synopsis of each fixed bug. 


100071-01 

100072-01 

100075-07 


100085-03 

100109-01 

100125-04 

100133-01 

100134-03 

100141-02 

100149-03 

100159-01 

100168-01 

100170-03 


1038313 Can’t open and use more than 64 windows concurrently 
1031577 modload does not recognize the "vector" keyword 
103 83 05 modload does not recognize the "vector" keyword 
1044565 pc-nfs client failed locking entire UNIX file 
10457 00 lockf fails when 2 procs try to read, write simultaneously 
1046001 fcntl is interupted by signals, returns the wrong err code 
104599 6 File locks not removed on server when a client is rebooted 
1045995 unlink(2) on a file prevents NFS file locks on same file 
1057 67 3 panic: iinactive may result from klm code 
10 5 63 0 0 failed tlock test #1; should ret EINVAL instead of success 


10 610 87 File /tmp./foo left on the server after a client reboot 
10 61173 File record can be read-, write-locked by diff procs simul 

103 957 6 selection_svc, rpc can be used to gain access to sys files 

104 0 606 selection_svc security problem 

1032 053 getreg should use fuword() when simulating instructions 

1054669 telnetd allows password snooping 

1036159 A user can run programs with root’s group privileges... 

103 0 087 sendmail yp aliasing does not work with non-sun yp masters 
1042 822 St: warning tape may be wearing.... on Exabytes 
103 983 9 nres_gethostbyaddr logs erroneous msgs to NIS server’s cns 
1041559 system is panicing in mclput 

1053 552 ip_input drops pckts w IP opts as bad checksum w mclput pnc patch 
103 9406 3960-3980th repeated sckt open & close fails w addr already in use 
1037 7 47 crontab -e doesn’t update file edited in less than 1 setup_c 1 ient 
1034833 Id: can’t mixed -r with -Bstatic or - A flag in 4.1 
1034788 -r and -pie do not mix bad secondary magic number on 4.1 
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100173-03 


100173-06 


100174-01 


100179-01 

100181-01 

100186-01 

100188-01 

100192-01 

100198-01 

100199-01 


100201-01 


100203-01 

100206-01 

100207-01 

100208-01 

100210-01 


1044524 

1042261 

1045272 

1037879 

1019004 

1039977 

1032959 

1029628 

1037476 

1038302 

1034328 

1045536 

1030884 

1045993 

1047557 

1052330 

1053679 

1041409 

1034328 

1045536 

1064433 

1066287 

1042350 

1038651 

1044192 

1043270 

1057963 

1049027 

1054054 

1047586 

1047355 

1039760 

1046945 

1008324 

1046046 

1037052 

1037715 

1039287 

1049125 

1057481 

1040465 

1044204 

1040334 

1047131 

1050040 

1038363 

1016767 

1045471 

1028856 


multiply defined symbols and seg. fault caused by 4.1 ’s Id 

Id only recognizes first directory in LD_LIBRARY_PATH 

Id -u & -r dont seem to work properly 

Cant create executble w shared obj which points to another 

-assert definitions can fail to report undefined symbols 

bug in the NFS DEBUG code, file nfs_export.c 

NFSPROC_MKDIR returns incrr attrbutes 

setuid bit copied to NFS file systm 

Sending bad proc to NFS server can cause mbuf leak 

NFS export option "anon=-l" does not work 

client can crash if two proc’s unlink same file at once 

NFS exports to non-Sun systems can result in file truncatn 

NFS full file sys gets ENOSPC even wn overwrit exist file 

NFS file caching still occuring on locked files 

Old pages not being purged if file truncated on server 

locking on NFS file doesn’t cause cache purged after 1st time 

file region locking of NFS files was broken in 4.x 

cannot execute setuid root pgms in NFS mounted filesystem 

client can crash if two procs unlink 

nfs exprts to non-sun sys can result 

Export of subtree doesn’t work 

nfs hang when looking at Ig file changed on server 

tmpfs problem with ftruncate test in SCTS from SUNVS 

Using tmpfs ie ram /tmp can cause data initlztn w Fortran on 4.1 

hard link to dir succeeds on tmpfs for non-root users 

tmpfs disallows mmap beyond EOF 

cannot mount exported tmpfs directory 

tmpfs hangs and deadlocks 

+s and -ft together do not work as expected 

mkfifo does not work on tmpfs 

polling not working correctly 

notifier fails to handle fcntl for FNDELAY correctly 

’ping’ caused machine to panic 

TIOCCONS is a security hole 

The colormap is not correct wn 128 colors used on 4.1.1 
shmdt(2) will not detach a read only segment 
ISO orderly release is not supported, but TCPTLI says so 
tcp/tli transport cannot send more than 4052 bytes of data 
System panic’s when reject a network connection via TLI 
System hangs when running TLI 
passwd -e cmd doesn’t work when c2 security is in place 
rpc.passwdauthd can be used to guess pswrds on c2 systems 
yppasswd wont allow user to change passwd from client... 
getauditflagscharO routine in 4.1 libc does not work 
fcvt() segment faults under 4.1.1 

window_destroy does not release memory; 8k memory leak per textsw 
/boot works for 1st disk controller only 
4.1 (+) shared C libraries reference undefined symbols 
master defaults database is not being read 
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100211-02 1038050 if an "eom" ioctl gets interrptd, tape synchronization lost 

100216-01 1046449 multiple-register sbus cards don’t work on a 4/75 

100217-01 1047295 mounting certain iso 9660 cd’s succeed but directory becomes data 

100224-02 1047340 /bin/mail can be used to invoke a root shell 

1045636 4.1 /bin/mail problem delivering mail 
100225-02 1048128 xon flow control problems on serial I/O 

100228-02 1032534 Kernel panics with panic: psig on exiting sunview 

100232-01 1050558 SPARCstation 2 running SunOS 4.1.1 crashes under some applications 

100243-01 1046580 bug in esp host adapter can cause panic during error recovery 

1048141 esp does not always recognize a marginal SCSI bus 
10463 05 some XXgetcap cases reversed 
100244-01 1052669 panic: data fault in strwrite - streams corruption 

100244-02 1033287 Frequent exhaustion of chanmap resource observed 

100249-01 1038308 4.1 automount sets up a different sym link 5 mins after 1 st access 

100250-01 1052659 FSR on the old SCSI tape driver fails in 4.1.1 

100251-01 1044909 /usr/lib/expreserve race condition used to break into a system 

100254-01 1044666 panic: ttcompat: unexpected ioctl acknowledgment 

100255-01 1044888 Streams run out of dblks and hang the system 

100256-01 1053733 pax gets into infinite loop at EOT 

100257-02 1033086 Calling dlopen() on a file with BSS kills your application 

10433 00 dlclose prevents access to functions even after further dlopen 
1052428 Id.so usage of -L options confusing, leads to security problems 
104637 9 cant call a fnctn in a shared lib from a fnctn in another ... 

1045194 dlsym returns bad addr for uninit global var in dlopened library 
10322 08 Idd doesn’t write file names if standard output is not a tty 
1032 209 Idd runs out of file descriptors 
1043 082 Bogus first arg to ’Idconfig’ kills dynamic linking 
100259-01 1054999 syncip overhead in ufs_inactive causes poor NFS performance 

100262-01 1052888 st driver can cause a panic: zero divide trap 

100265-01 1039275 writing to an PROT_READ area is giving SIGBUS not SIGSEGV 

100266-01 1038500 localtime or tzsetwall corrupts malloc space (libc) 

100268-02 1051880 colldef input format not documented 

1051881 colldef rejects apparently valid inpt 
1051882 semantics of colldef are unclear 
10518 83 spelling error in colldef message 

1052 463 colldef can’t handle a substitute statement with hex numbers 

1053 3 4 6 There shouldnt be an imposed length limit for strings in strcoll() 

10 523 98 strxfrm is not 8 bit clean 


100273-01 1038686 System panics with "panic: hat_ptesync - invalid pme" message 

1043 801 panic: assertion failed, pmg->pmg_keepcnt == 1 
100275-01 1057211 VME master bus accesses can time out during heavy I/O 

100281-01 1057 685 4.1.1 nfs servers freezing 

100294-01 1056245 Process hangs in page_cv_wait, ufs_getapage after locking page 

1051992 pageout and clustering are not cooperating 
105187 6 system hangs when pageout sleeps in ufs_putpage 
105054 6 putpage can hang the box 
104 5582 Newsprint 1.0 hangs on 4/75 and 4/40 
100305-06 1016437 Ipd does not check file names for legality 

1058003 Reading from /dev/printer, Ipd does not check how much it has read 
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10637 72 possible to overwrite a file on system using Ipr 
100313-01 1044668 umount/sync race can hang system 

100330-02 1051983 buffer cache sz decreases w Ig kernels causing high 

1056992 4.1.1 leaks kemelmap 

1057 92 9 sys hang: prestosrve and NC400 exhausting kemelmap 
100346-01 1044722 undefined symbol in libxpg. a 

100349-02 1066773 k_pick_echo_struct_en_range_plus_descendants may stop echoing in a descendant 

100356-01 1067615 kernel hangs while processing aloeancel system call 

100357-01 1066663 SIGIO signal for async io fails to pend across NFS (patchid 

100364-01 1029802 4/280 with xy451 panics; regs accessed while busy 

100376-01 106907 2 Int div on spare can be used to modify data 

100376-02 1069702 Integer division on SPARC can be used to gain root access 

6.14. CTE OpenWindows Version 2 Patches 

Patch-ID# 100131-01 Synopsis: Custom CADENCE xnews server with two bug fixes Bugs Fixed: 1043582 popup 
windows cause damage if the are partially off screen. 1043824 Intermittent failure to deactivate automatic pointer 
grab. 

Patch-ID# 100156-01 

Synopsis: xauth sets wrong hexkey data in the add displayname option 
Bugs Fixed: 

1045483: xauth sets wrong hexkey data in the add displayname option 
Patch-ID# 100158-01 

Synopsis: xview notifier cannot handle number of files >31 
Bugs Fixed: 

1040844: xview notifier cannot handle hides >31 
Patch-ID# 100166-01 

Synopsis: PANEL_SLIDER SEGVs when slider bar is moved - monochrome only. 

Bugs Fixed: 

1042937: PANEL_SLIDER SEGVs when slider bar is moved - monochrome only. 

Patch-ID# 100176-08 

Synopsis: OpenWindows 2.0: Patch release 8 for Xll-NeWS server 
Bugs Fixed: 

1040959 - odd line widths identical to even widths (5==4) shapes bug. 

1043824 - Intermittent failure to deactivate automatic pointer grab. 

1043582 - popup windows cause damage if the are partially off screen 
1041986 - XGetImage will crash server if planemask is set to AllPlanes... 

1043914 - CharStrings does not contain entries for unencoded characters. 

1044043 - pointer grabs generate incorrect enter/leave events. 

1044086 - incorrect rendition of some stroke characters NeWS bug. 

1044246 - killing a client while the server is grabbed causes SEGV 
1044315 - The server can get into an infinite loop and consume epu time 
1044475 - XDrawArc doesn’t draw large circles correctly 
1045150 - R to L copies less than one longword. 
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1046997 - server hangs if button event generated when socket is full 
1045563 - XDrawLine with negative points crash the server 
1045650 - Bad pixmaps are created and NO ERROR is returned.... 

1045652 - Creating 100 to 200 pixmaps causes the server to crash 
1045857 - FrameMaker 2. IX crashes server 
1045887 - cgsix, spare station, server crashes on XDrawSegment 
1047358 - KeymapNotify events being generated in the wrong order. 

1047494 - News line > 1 cap style CapRound, caps hanging bug. 

1048120 - News line > 1 not drawn correctly if cap style CapRound. 

1050109 - Line Width > 1 not drawn correctly. 

1051287 - DGA leaves file descriptor open for color map. 

1051689 - Short rlineto lose accurate current point for wide lines. 

1051848 - Plane masking bug. 

1052157 - xcs_clear sh_mem_fill clear region server crash. 

1052239 - sh_Shape_Raster() bad calculation memory corruption core dumping. 
1052479 - Out of bounds framebuffer access. 

1052697 - Out of bounds framebuffer access. 

1052712 - Newsprint imagecanvas boundaries rounding bug. 

1052749 - Shapes bad calculation memory corruption core dumping. 

1052822 - Out of bounds framebuffer access. 

1053164 - Fill operator causes dropouts of Type 3 Fonts. 

1053342 - Visibility Notify not received when window partially obscured. 
1053511 - Windows over 32000 pixels BadAlloc shapes bug. 

1053954 - Visibility Notify enabled impacts server performance. 

1054009 - Set screen saver bug. 

1054362 - Postscript accentuated characters disappear text shifts. 

1054811 - News Lotus graphs not rendering right and bottom lines. 

1054918 - XNeWS would not render 256 colors. 

1055187 - XFillRectangle on a cg3 stipple incorrect results. 

1055265 - Plaid OW demo crashes LSCrev2 legosc 
1055656 - XSetFillStyle FillTitled stipple fill incorrect. 

1055672 - Pageview does not display Postscript document correctly. 

1056088 - Protect the server from out of framebuffer accesses. 

1056131 - Closepath doesn’t produce a line join if last element zero length. 
1056324 - Newsprint Sparc Printer Bad Line Widths. 

1056454 - Frame on OWV2 can crash legosc quadro systems. 

1057110 - LSC Rev 2 chip has bug in frame buffer arbitration. 

1057234 - XGL and server graphics can crash legosc. 

1057502 - Doubledash lines not rendered when rop set. 

1057750 - xcs_clear xcsProcs shapes fill area needs range clipping. 

1058592 - XSetClipRectangles inconsistent clipping action bug. 

1058818 - xc_create_transmem_raster not clipping child raster to fit parent. 
1059182 - Postscript file will not render properly. 

1059186 - Postscript line drawing and rendering bug. 

1059230 - SparePrinter won’t print excel postscript files. 

1059933 - Can’t printout NeWSprint characters are upside down. 

1060093 - Stippling and clipping not displayed correctly. 

1060964 - colormap corruption server core dump when running props. 

1061098 - XI1 wide lines coincident first & last points not joined. 
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1061305 - XDrawArcs test in MIT Xlib test crashes xnews server. 

1061436 - xnews return wrong Fontmatrix on redefined font PostScript bug. 

1061881 - do not return per character metrics for fixed size fonts. 

1062574 - Window grabber clip problem cv_unmap. 

1062616 - page view will send xnews process into an infinite loop 
1062834 - events open declaration syntax error. 

1063240 - docviewer intro screen corrupted after installing xnews patch. 

1063261 - cv_reshapecanvas to send expose properly. 

1063464 - ListFontsWithInfo slow performance. 

1063821 - window mapping bug. 

1069548 - poor performance of XQueryFont 

1069590 - xnews server crashes after allocating 216 colors 

Also fixed (no bugid’s): 

- Tile and Stipple related bug fixes. 

- XGetImage ZPixmap transfered whole raster error. 

- Shape_Obj excessive local temporary shapes being created. 

- DragAndDrop cursor does not appear. 

- Snaptool does not work correctly. 

- AnswerBook does not display pages correctly. 

- Performance enhancements for font queries 

- psterm title bar does not repaint after resizing 

- IslandDraw core dumps at startup time 

- VideoPix’s vfctool dies with X error 

- Mwg does not repaint root window correctly 

Patch-ID# 100183-01 

Synopsis: Openwin 2.0:rescale font to 60pt size and convert to vfont doesn’t work 
Bugs Fixed: 

1045767: when you rescale folio font to 60pt size and convert to vfont, it dent work 
Patch-ID# 100184-02 

Synopsis: sv_xv_sel_svc and rpc can be used to gain access to system files 
Bugs Fixed: 

1040747: sv_xv_sel_svc and rpc can be used to gain access to system files. 

Patch-ID# 100205-01 

Synopsis: Highligting problems within filemgr running on Xterminals. 

Bugs Fixed: 

1045939: filemgr incorrectly inverts icons on a NCD mono X terminal 
Patch-ID# 100213-01 

Synopsis: Application core dunps when user selects text item and drags it on the scrolling list. 
Bugs Fixed: 

1047260: drag text field into scroll list causes app. core dump 
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Patch-ID# 100231-01 

Synopsis: PANEL_LABEL_WIDTH does not set button size correctly. 

Bugs Fixed: 

1037262: PANEL_LABEL_WIDTH doesn’t work 
Patch-ID# 100245-01 

Synopsis: olwm banding bug, label centering bug 
Bugs Fixed: 

1038716: Olwm window labels are not always centered properly. 

1047748: Olwm can get into the "move window" rubber banding mode by mistake. 

1055511: Olwm save workspace only works for WM_SAVE_YOURSELF clients. 

1053101: Olwm XV_SHOW fails when DISABLED and ENABLED quickly. 

Patch-ID# 100246-01 

Synopsis: panel buttons fail when multiple server connections are made. 

Bugs Fixed: 

1041574: panel buttons fail when multiple server connections are made. 

Patch-ID# 100247-01 

Synopsis: Xview libraries multiple bug fixes. 

Bugs Fixed: 

1051808: Control panel with a scrolling list sometimes displays wrongly sized. 

1048055: Canvases and control areas < 2 pixel apart draw in wrong size. 

1028072: xv_set for scrolling lists has side effects. 

1046128: Non-exclusive menus calling wrong notify proc when item selected. 

1045626: Can’t specify different font for each panel item. 

1049478: Panel buttons only inherit panel fonts conditionally. 

Patch-ID# 100352-01 

Synopsis: bldfamily, convertfont & makeafb compress fontnames causing conflicts 
Bugs Fixed: 

1043430: convertfont & bldfamily default filename length too small 
1052174: bldfamily should handle font name conflicts better 

Patch-ID# 100354-02 

Synopsis: cm displays NoName as user if user has a in it’s name 
Bugs Fixed: 

1046847: cm comes up with NoName displayed as user if user has a "-" in it’sname. 

Patch-ID# 100355-01 

Synopsis: OpenWindows 2.0: patch for panel text item bug 
Bugs Fixed: 

1065873: PANEL_VALUE_DISPLAY_LENGTH in text item does not work for values les than 4 
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Patch-ID# 100366-01 

Synopsis: filemgr does not handle automounted directories correctly 
Bugs Fixed: 

1043301: subdirectory mounts don’t work with hierarchical mounts 
1040123: indirect maps creates symbolic links inconsistently with subdirecto 

Patch-ID# 100367-01 

Synopsis: Cursor advances too far when using compose key in OLIT 2.5 appl. 
Bugs Fixed: 

1067129: TextEdit widget does not insert 8-bit characters correctly 
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Part 3 — Installation and System 

Configuration 


Part 3 includes the following chapters: 

• Chapter 7, “Installation Notes and Warnings” 

• Chapter 8, “System Configuration” 


Part 3 — Installation and System Configuration — Continued 



7 

" ' —^^- 

Installation Notes and Warnings 


Be sure to read this chapter before proceeding with installation of SunOS 4.1.2. 

This chapter provides information about the installation of SunOS 4.1.2, includ¬ 
ing warnings about OpenWindows restrictions. It also contains information 
about installation of unbundled products, including warnings about the incompa¬ 
tibility of some versions of these products with release software or other Sun pro¬ 
ducts. 


7.1. Upgrade Utility 
Available 


SunOS 4.1.2 includes sunupgrade, a utility for upgrading from SunOS 4.1.1 
or SunOS 4.1.1 Rev B to SunOS 4.1.2. See Installing SunOS 4.1.2 System 
Software for a description of the upgrade procedure. 


7.2. Do Not Install Earlier Many patches that were needed in SunOS 4.1.1 and SunOS 4.1.1 Rev B have 

Patches to SunOS 4.1.2 been included in SunOS 4.1.2. Check with your local Sun Support center if you 

are unsure if a particular patch has been included in SunOS 4.1.2 or to see if a 
SunOS 4.1.2 version of the patch is available. 

Do not install any patches from earlier releases after installing SunOS 4.1.2; this 
may cause your system to crash. 



7.3. Installing Unbundled 
Products on a Server 
Supporting Multiple 
Releases 


Clients running a different release than their server do not have access to unbun¬ 
dled products installed in directories belonging to the server’s release. In some 
cases, this means that cdmanager or extract_unbundled, the installation 
tools for unbundled products, has to be run separately for each release. In other 
cases, a workaround of several steps may be necessary in order to make a product 
available to a client. 

Unbundled products are loaded on a system using cdmanager or the 
extract_unbundled installation script. For many products, the script 
allows the user to specify the receiving directory. When this is the case, 
cdmanager or extract_unbundled can simply be run more than once to 
install a given product in different release directories. 
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For some products, however, the receiving directory is hardcoded into 
cdmanager or extract_unbundled. In such cases, cdmanager or 
extract_unbundled will load a product in a directory belonging to the 
server’s release, where it is not available to clients running under a different 
release. 


Workaround to Install The following workaround shows how to install language products so that they 

Language Products for a are accessible to clients running a different release from their server. The same 

Client’s Release approach can be applied to other products whose paths are hardcoded in 

cdmanager or extract_unbundled. 

The workaround uses the example of a sun4c client running SunOS 4.1.2 on a 
Sun-4 server running under SunOS 4.1.1. All language products belonging to the 
server’s application architecture are loaded into the server’s /usr / lang direc¬ 
tory. It is assumed that extract_unbundled has already been run to install 
language products on the server. A partial file listing of the server’s 
/export/exec directory shows: 


drwxr-sr-x 

3 

root 

512 

Jun 

8 

13 : 38 

kvm 


drwxr-sr-x 

9 

root 

512 

Mar 

6 

17:26 

proto.root.sunos.4.1 

.1 

drwxr-sr-x 

9 

root 

512 

Jun 

1 

11:38 

proto.root.sunos.4.1 

.2 

drwxr-sr-x 

3 

root 

512 

Jul 

23 

15:02 

sun3 


Irwxrwxrwx 

1 

root 

4 

Jun 

7 

20:34 

sun4 -> /usr 


Irwxrwxrwx 

1 

root 

4 

Jun 

7 

20:34 

sun4.sunos.4.1.1 -> 

/usr 

drwxr-sr-x 

29 

root 

1024 

Jun 

25 

09:14 

sun4.sunos.4.1.2 



To install a language so that it is accessible to a client running a different release 
than its server: 

1. Halt all processes on systems belonging to the server’s release and the 
client’s release that might try to access binaries in the server’s /usr / lang 
directory. In this example, halt all sun4 and sun4c clients. 

2. Change directories so that you are in the server’s receiving directory. In this 
case: 



4. If you do not already have a directory for receiving the product on the client 
system, set it up now. For example: 
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5. Create a link to the client directory that is to receive the product: 



6. Use extract_unbundled to install the product. 

7. Remove the link from /export / exec / sun4 / lang to the client’s 
receiving directory: 



8. Restore the original language directory whose name you changed: 



7.4. OpenWindows Version OpenWindows Version 2 and OpenWindows Version 3 are described in Chapter 
2 Restrictions 3. Note the following about OpenWindows Version 2 before you begin installa¬ 

tion of the release. Also, see Chapter 10 in the Open Issues package for descrip¬ 
tions of OpenWindows bugs. 

Do Not Install Sun IPX This patch has been incorporated in the OpenWindows Version 2 included with 

Supplement SunOS 4.1.2; the patch is unnecessary. Do not install it. 


OpenWindows Does Not Fit OpenWindows requires over 30MB of disk space. This is more than will fit on a 
on 104MB System Disks 104MB disk loaded with even a minimal version of SunOS4.1.2. See “Desktop 

SPARCsystem with Two 104MB Disks: Using Second Disk for /home and 
Additional Swap Space” and “Desktop SPARCsystem with Two 104MB Disks: 
Using Second Disk for OpenWindows” in Chapter 8 for descriptions of the 
methods for using a second 104MB disk for either /home or for OpenWindows. 

SMB Main Memory, 20MB In order to run OpenWindows, your system must have at least eight megabytes of 

Swap Partition, Required main memory. Twelve megabytes or more are recommended. 

Before installing OpenWindows software on your system, you need to make sure 
that your swap partition is at least 20MB; 24MB or more is recommended. 
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OpenWindows Requires 
SunView Libraries In Order 
to Run 


In order to run OpenWindows, you must have the SunView_Users software 
category installed on your system. SunView_Users contains libraries needed by 
OpenWindows. Without SunView, you get the message: 


r 

N 

Id.so: libsuntool.so.0.## not found 


(_ 

y 


7.5. Graphics: A special patch tape (SunOS 4.1 GFX Rev 1) was provided for running GFX 

graphics under SunOS 4.1; two patch tapes (SunOS 4.1.1 GFX Rev 1 and SunOS 
4.1.1 GFX Rev 2) were provided for running GFX graphics under SunOS 4.1.1. 
SunOS 4.1.2 now incorporates the contents of these tapes. 



If you install SunOS 4.1.2 and then try to install any of the SunOS 4.1 or SunOS 
4.1.1 GFX patch tapes, you will crash your system. 


7.6. Hardware Patches 


Do Not Install SunOS 4.1 
Patch for Running 
SPARCprinter on 4.1.2 
System 


The Read This First (RTF) with Sun’s SPARCprinter instructs the user to install 
a patch for running the printer under SunOS 4.1. The patch is now incorporated 
in SunOS 4.1.2 and the RTF’s instruction should be disregarded. 



If you install SunOS 4.1.2 and also try to install the patch from SunOS 4.1 you 
will destroy your kernel and crash your system. 


Do Not Install Sun 1.3GB Disk A special patch was provided for Sun-4 systems running SunOS 4.1.1 and Sun-4c 
Enhancement systems running SunOS 4.1.1 Rev B, to enable use of the 1.3GB disk on these 

systems. The changes have been incorporated in SunOS 4.1.2; the patch is 
unnecessary. Do not install it. 
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7.7. Prestoserve 2.0 and 2.3 Prestoserve 2.0 has been superceded by Prestoserve 2.3, which only supports 

Sun-4c and Sun-4m machines. If you have a Sun-4 machine, you can continue to 
use Prestoserve 2.0 with SunOS 4.1.2. 

Error Message During During installation of Prestoserve 2.3 on a SunOS 4.1.2 system, the following 

Prestoserve 2.3 Installation message sequence will be displayed: 

2.3_Prestoserve : This software is not compatible with the 
current operating system 

This is the list of compatible operating systems: 

4.1.1 

Do you want to continue? [yin] 

V_7 


Respond “y” and Prestoserve 2.3 will be successfully installed. 


Prestoserve 2.0 Sundiag 
Problem (1067352) 


The Sundiag menu for Prestoserve 2.0 shows both a user test and device test for 
Prestoserve. Run only the device test. 


7.8. NSE 1.2 not 
Compatible with 
SunOS 4.1.2 


Do not use NSE (Network Software Environment) Release 1.2 on a system run¬ 
ning SunOS 4.1.2. If you run NSE 1.2 under SunOS 4.1.2, it will corrupt some 
system files and may cause a system failure. This problem is corrected in NSE 
1.2.1 and subsequent releases. 


7.9. Sun DBE 1.0 and 1.1 Do not use SunDBE 1.0 or SunDBE 1.1 with SunOS 4.1.2; they are not sup- 

Not Supported under ported and they will not work. 

SunOS 4.1.2 


7.10. Sun Cross Compilers Do not use Sun Cross Compilers 3.0 with SunOS 4,1.2; it is not supported. 

3.0 Not Supported 
under SunOS 4.1.2 

7.11. SunTrac Tutorial The SunTrac tutorial program contains reference to a Play, that has its starting 

Date Errors date on 01/01/90. Since the real date is now greater than that date, a feature of 

the product is activated which requires the user to modify a considerable number 
of dates in the Tutorial. This can hinder testing considerably and create docu¬ 
mentation errors. The Clear Date Error menu item will clear the date 
errors each time they are encountered. 
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7.12. SPE 1.1 Problems 

SPE Build Failure 


Stack Overflows 

7.13. SunShield 1.0 on 
SunOS 4.1.2 


The following two problems may be eneountered running SPE 1.1 under 
SunOS 4.1.2; the first problem has been fixed in SPE 1.2. 

If SPE 1.1 is built (using the $SPE_ROOT_DIR/build-spe script) under 
SunOS 4.1.2, it will fail after trying to write the SPE image to a nonexistent 
directory. That directory will be either 

$SPE_ROOT_DIRECTORY/sun3-unknown 

or 

$ SPE_ROOT_DIRECTORY/sun4-unknown 

depending on the application architecture of your system. 

There are two ways to avoid this problem. The first solution is to link the nonex¬ 
istent directory to 

$SPE_ROOT_DIRECTORY/sun3-4.0 

or 

$SPE_ROOT_DIRECTORY/sun4-4.0 

(whichever is appropriate to your system). 

Alternatively, you can edit the $SPE_ROOT_DIRECTORY/os shell script, 
changing 

/SunOS Release 4.0/ 

to 

/SunOS Release 4./ 


The second SPE problem is caused by stack overflows, which may cause the Lisp 
process to die. Specifically, overflowing the stack and then, without first unwind¬ 
ing the stack, overflowing it again (recursive stack overflows) will kill your sys¬ 
tem. Avoiding these stack overflows, especially recursive stack overflows, will 
prevent this problem. 


To install SunShield 1.0 after installing SunOS 4.1.2, you must extract the patch 
from the SunOS 4.1.2 CD-ROM, as described below. 

1. Insert the SunOS 4.1.2 CD-ROM into the drive. 


2. Unmount the CD-ROM if it is mounted: 



.A 

# cd / 


umount /dev/srO 


V 

) 


3. Run extract_patch: 

^^ ^ 

# /usr/etc/extract_patch -parm_l_0 

V ___^_ ■■ •• _^___:_^^_ 


A. Change to SunShield (“arm”) directory and untar the patch: 
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r 

# cd /usr/tmp/ann__1^0 

# install arm 10 


V .. 

/ 

5. Respond y to question; 

r 

You need a ARM/ASET CD to continue. 

Do you still want to continue [yln]? y 


V _ 

__y 

6. Respond y when asked if CD is inserted : 

Please insert the ARM/ASET CD. 

Is the CD inserted? [y] :y 

A 

V _ 

__^_y 

7. Designate cdm or cdmanager as the tool to use: 

1 

which tool do you want to use? 

1. cdm 

2. cdmanager 


Your selection;! 



) 


You can use cdm whether or not you are running OpenWindows; you must 
be in OpenWindows to run cdmanager. Follow the self-explanatory 
prompts to complete the installation of the patch. 


7.14. SunNet/SunLink When installing some 6.0 and 6.1 SunNet/SunLink products, you must run the 

Networking Products /usr/etc/sunlink. install script you run 

extract_unbundled, but before you run any product-specific installation 
scripts. If you do not run sunlink. install first, the product-specific instal¬ 
lation scripts fail. 

The new installation steps are as follows; 

1. Run /usr/etc/extract_unbundled to extract the product off the 
tape. 

2. Run /usr/etc/sunlink. install, selecting the product being 
installed. 

3. Run any product-specific installation or configuration scripts according to 
the product documentation. 

The following list indicates the affected SunLink products. Note that some of the 
products in the list have been superseded by later versions, which may not cause 
any installation problems. 
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6.1 BSC3270 

6.0 BSCRJE 

7.0 Channel Adapter 

6.0 DON 

6.0 DNI* 

6.0 HSI 
6.0 INR* 

6.0 MCP* 

6.1 SNA3270 
6.0 Peer-to-Peer 

*There may be additional steps for these products. See the next sections for 
details. 

Installing the Internetwork If you are installing the SunLink Internetwork Router on a system that is running 

Router SunOS 4.1.2, you must perform the following step: 

After you run the extract_unbundled and sunlink. install scripts, 
but before you run the install. inr script, enter the following command as 

root: 


where arch is a directory name that designates your machine architecture, for 
example, sun4 for a Sun-4. You can then proceed to run install. inr as 
documented in the SunLink Internetwork Router System Administration Guide. 


Exporting SunLink Software When you install SunLink software, the installation script installs the software 

for Multiple SunOS Versions only in the hierarchy for the SunOS version that the machine receiving the instal¬ 

lation is running. That is, if you install on a machine running SunOS 4.1.2, the 
SunLink software goes into the hierarchy for 4.1.2. If that machine is a server 
that has diskless clients that are running different SunOS versions from the 
server’s and that require access to SunLink software, you must do the following: 

• Create a sunlink mount point at the end of the version-specific hierarchy 
that the client mounts on /usr. 

• Edit the client’s f stab file so that the client mounts the hierarchy where the 
SunLink product was installed on the newly-made mount point. 
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For example, assume you have a Sun-4 server running SunOS version 4.1.2 that 
serves diskless Sun-4s running SunOS 4.1.2 and SunOS 4.1.1. Your 4.1.1 clients 
mount one hierarchy as /usr: 


\ 

/export/exec/sun4.sunos.4.1.1 

^ ___ ) 


while your 4.1.2 clients mount a different hierarchy as /usr: 


/export/exec/sun4.sunos.4.1.2 

_2 


After you install SunLink software on the server, it is available as: 

- 

/usr/s unlink / <product_name> 

/ export / exec / sun4 / sunl in]^ / <product_name> 

/export/exec/sun4 . sunos .4.1 .1 /sunlink/<product_name> 

^ _> 


To allow your 4.1.2 clients to access the SunLink software, use the following 
commands to create the mount point sunlink: 

- 

server# cd /export/exec/sun4.sunos.4.1.2 
server# imkdir sunlink 

\_ J 


Note that the hierarchy /export/exec/sun4 . sunos . 4.1.2 is already 
mounted as /usr on the 4.1.2 clients. In the f stab for these clients, add an 
entry so that /export/exec/sun4 . sunos .4.1.1/sunl ink (the hierar¬ 
chy that contains SunLink software) is mounted on the newly created mount 
point /usr/sunlink after the /usr entry, for example: 
- 

<server>:/export/exec/sun4.sunos.4.1.2 /usr nfs ro 0 0 

<server>:/export/exec/sun4.sunos.4.1.1/sunlink /usr/sunlink nfs ro 0 0 
v_ 


setsid Problems When If you install SunOS 4.1.2 on a machine running SunLink DNI 6.0, you must 

Running SunLink DNI 6.0 provide a “wrapper” around the DNI virtual terminal daemon (dnilogind) so 

that it conforms to the POSIX- standard requirements for acquiring a controlling 
terminal. This problem does not exist with DNI 7.0. 

To allow a Sun node to remain accessible via SunLink DNI when a set host 
command is issued on a VAX/VMS t system, as root, enter the following com¬ 
mands after DNI installation is complete: 


t VAX and VMS are trademarks of Digital Equipment Corporation. 
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# c<a /usr/sunlink/dni 

# mv dnilogind .dnilogind 

# cat > dnilogind 

#!./ban/sh 

/usr/etc/setsid -b /usr/sunlink/dni/.dnilogind 
"D 

# chmod a+x dnilogind 

V_ _ _ J 

It is not necessary to reboot your machine. 

For background on the reasons for this requirement, see the man page on 

setsid (8V). 

If you install SunOS 4.1.2 on a machine running SunLink X.25 6.0, you must 
provide a “wrapper” around the X.29/X.3 server (x2 9) so that it conforms to the 
POSIX- standard requirements for acquiring a controlling terminal. This is fixed 
in X.25 7.0 and subsequent releases. 

As root, enter the following commands after X.25 installation is complete: 

# cd /usr/sunlink/x25 

# mv x29 .x29 

# \ catv >■ x29 -- - 

#!/bin/sh ... 

/usr/etG/setsid -b /usr/sunlink/x25:/.x29 "$@" 

# chmod a+x x29 

V. _ .■ ■ ' ' 'r': '.'"v.V 

It is not necessary to reboot your machine. 

For background on the reasons for this requirement, see the man page on 
setsid (8). (This man page is not present in previous SunOS versions.) 

On page 35 of the SunLink BSC3270 System Administration Guide the instruc¬ 
tions for booting from the newvmunix kernel are incorrect and will generate 
incorrect output from a number of subsequent commands. The correct instruc¬ 
tions are: 

1. Copy the new kernel, newvmunix, to the root (/) directory. 

2. Change the name of the original vmunix kernel to vmunix. old and 
change newvmunix to vmunix: 


Incorrect Instruction in 

SunLink BSC3270 System 
Administration Guide 

(1044933) 


setsid Problems When 
Running SunLink X.25 6.0 


# mv vmunix ymunix.old 

# mv newvmunix vmunix 

V_^__y 


3. Reboot your system 
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7.15. Language Products The following topics are described in this section: 

• Sun C-i-i- 2.1 Patch Installation 

• FORTRAN 1.4 Patch Installation 

• Pascal 2.1 Patch Installation 

• FORTRAN, C, Pascal, Modula-2: Missing Debugging Libraries 

• FORTRAN 1.2 Problems 


SunOS 4.1.2 introduces new library functions and system calls. For Sun C-i-i- 2.1 
to run under SunOS 4.1.2 you must install a patch. This section describes how to 
install the patch. 

The patch includes the following: 

• A README file, 

• The patch installation script 

• A directory with header files for SunOS 4.1.2. 

Where is the Sun C-i-l- Patch Install the patch in the directory in which Sun C-i-f- 2.1 was previously installed. 

Installed? The default is /usr / lang for standalone and homogeneous servers. You may 

also specify a non-default directory as the installation directory. Just make sure 
it exists and that you have already installed Sun C-t-4- 2.1 in it; otherwise, the ins¬ 
tallation script will not allow you to install the patch. 

The patch script will alter the original SCI. 0 / include/CC header file direc¬ 
tory, and some of the original SCI. 0 / include/CC header files will be lost. 


Sun C-I-+ 2.1 Patch 
Installation 



Install or upgrade to SunOS 4.1.2 and Sun C++ 2.1 before you install the Sun 
C++ 2.1 patch. 

If you do not understand the terms used here, see the installation instructions in 
the Sun C++ 2.1 Read This First. 


Preparing for Patch Installation If you are installing on a standalone workstation and using the default installation 

directory, you may use default installation directions. If you are going to install 
the software onto a server, follow the non-default installation directions. If you 
need additional information, see the man page for extract_patch(8). 

Patch Installation to Default After installing SunOS 4.1.2 and C-I-+ 2.1 from the SunOS 4.1.2 CD-ROM, do the 

Directory following to install the C-t-i- patch in /usr / lang, the default installation direc¬ 

tory for 2.1. 

1. Insert the SunOS 4.1.2 CD-ROM into the CD-ROM drive and mount the 
CD-ROM. 
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Patch Installation to a Non- 
Default Directory 


2. su to root and extract the patch directory by typing the following on a 
command line: 

- 

# /usr/etc/extract_patch -DEFAULT -pcpluscpl\is_2^1 

I_ '. . 

The script will extract the patch files from the CDROM; if the default desti¬ 
nation, /usr/lang, exists and contains the directory 
SC 1.0/ include/CC, the script will display the README file and ask if 
you want to continue: 


r 



Ready to install C++ 2.1 

patch for 4.1.2 in /usr/lang 


Do you want to continue: 

[yin]? 






3. 

Enter y: 


n 

ll|fl 



■ 


1 

■ 






J 


Sun C-n- 2.1 should now work under SunOS 4.1.2; if it does not, contact your 
local Sun Answer Center. 


After installing SunOS 4.1.2 and C++ 2.1 from the SunOS 4.1.2 CD-ROM, do the 
following to install the C++ patch to a directory other than /usr/lang, the 
default directory. 

1. su to root and extract the patch directory by typing the following on a 
command line: 

/St-. . 

# /usr/etc/extract_patch -pcpluscplus_2_l 

The script will extract the patch files from the CDROM, display the 
README file, and ask you whether you want to execute the patch installa¬ 
tion program. Enter y. 

2. Reply y when asked if you want to see a description of the patch script: 

r . ..N 

Do you want to see a description of this patch script CyJnl? Y 

Patch of Sun C++ PCS release 2.1 for SunOS 4.1.2 

Patching should take approximately 1 minute. 

V...... 

3. If you are installing the patch on a machine that is running on SunOS 4.0, 
4.1, or 4.1.1 you will see the following message: 


#sun 

miorrket/etAmc 
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FORTRAN 1.4 Patch 
Installation 


-— . 

WARNING: This patch script is for Sun OS 4.1.2 
You are running it on Sun OS 4.0 or 4.1 or 4.1.1 
Do you want to continue anyway [y|n]? 

V ___^ 

Enter y if you are installing the patch into a server running on SunOS 4.0, 
4.1, or 4.1.1 that will support machines running on SunOS 4.1.2. 

4. Respond to the script’s questions about what type of system you have (stan¬ 
dalone or server), what type of server (always choose homogeneous), and 
what type of client will the product run on (sun4 only). 

After you answer the questions, the script will display the default Sun C-i-l- 

2.1 directory for your configuration: 

-- 

Currently the default C++ 2.1 directory is /usr/lang 
Do you want to change the default directory [y|n]? 

V _ 


5. Enter n if the default directory is correct. Enter y if you want to specify a 
different directory. You will then be asked to type in the name of your ins¬ 
tallation directory. 

6. See Step 2 under the “Default Patch Installation,” the script will continue in 
the same manner. 

Sun C-i-f- 2.1 should now work under SunOS 4.1.2; if it does not, contact your 
local Sun Answer Center. 

Install the FORTRAN patch in the directory where FORTRAN is installed; 
/usr/lang/SCl. 0 or /usr/lang/SCl. 0.1 is the default location. You 
may also specify a non-default directory as the installation directory. Just make 
sure it exists and that you have already installed SC 1.0 or SC 1.0.1 FORTRAN in 
it; otherwise, the installation script will not allow you to install the patch. 

The patch installation requires 3.8MB in /usr/tmp and 3.8MB in /tmp. Do 
the following to install the patch: 

1. Become root and extract the patch directory by typing the following on 
a command line: 

# /ti»r/«te/extractjpat:ch -iMPAITOf -pforfcraii_scl_0 

V___ ) 


This script will extract the patches from the CD-ROM and place them into 

/tmp/fortran_scl_0. 


2. Change to the directory just created: 


r . 

.. 

# cd /tinp/fortran_scl_0 



J 


3. Copy the files in /tmp/fortran_scl_0 to </a/igdir>/SC1.0, where 
<langdir> is the location you installed the FORTRAN compiler (default is 
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/usr/lang). 

4. Replace the libraries in SCI . 0 or SCI .0.1 with those in 
/tmp/fortran_scl_0 

5. Execute ranlib -t on all of the . a and . sa files copied. 

Pascal 2.1 Patch Installation Install the Pascal patch in the directory where Pascal is installed; 

/usr/lang/SCI, 0 or /usr/lang/SCI. 0.1 is the default location. You 
may also specify a non-default directory as the installation directory. Just make 
sure it exists and that you have already installed SC 1.0 or SC 1.0.1 Pascal in it; 
otherwise, the installation script will not allow you to install the patch. 

Do the following to install the patch: 


1. Become root and extract the patch directory by typing the following on 
a command line: 



This script will extract the patches from the CD-ROM and place them into 

/tmp/pascal_scl_0. 


2. Change to the directory just created: 


/ 


# cd /tmp/pascal_scl__0 



J 


3. Copy the files lipbc. so. 2.2.1 and lipbc. sa. 2.2.1 to 
<langdir>ISC\Si, where <langdir> is the location you installed the Pascal 
compiler (default /usr/lang). 

4. Run ranlib: 

# ranlib -t <langd/r>/SC1.0/lipbc.sa.2.2.1 


FORTRAN, C, Pascal, If you are trying to debug or profile with C, FORTRAN , Pascal, or Modula-2, you 

Modula-2: Missing Debugging may get an error message indicating that a particular function is missing. This 

Libraries may be missing profiling or debug libraries. 


For example, if the profiling libraries are not loaded, you will get a message as 
shown below. 



^ 

% til -p test.f 

1 

test.f: 

Mb 

MAIN bork: 

1 

Id: -lc_p: No such file or directory 

1 



V_____—— 



Ask your system administrator to help you install the missing libraries. 
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FORTRAN 1.2 Problems The installation of FORTRAN 1.2 may fail on SunOS release 4.1.2. This problem 

is fixed in FORTRAN 1.4. 

To fix this problem, modify the /usr/tmp/1.2_f ortran file and restart the 
installation as indicated below. 

1. Stay logged in as superuser. 

2. Change directory to / u s r /1 mp 

^ __ ^ ^ ____ ^ 

% cd /usr/tmp 

C. ..^.■ _^ .:: _^_ '..7.1.:. _ 


3. In any editor, revise the /usr /tmp/1.2_f ortran file as follows: 

Change: SOS_COMPAT= "4.0" 

to: SOS_COMPAT= "4.1.2 4.1.1 4.0" 


and save the file. 

4. Issue the following command: 

-^ 

% /usr/tmp/unbundled/l,2_fortran -ddev 

V_ J 

Where rmtjiost is the name of the remote host if the tape is mounted 
remotely, and dev is the device specification (stO, mtl, etc.). 

5. Restart the installation. 

--- ^ ^ ^ --^ 

% install_unbundled 

v_/ 


7.16. Type-4 Keyboard 
Compatibility with 
Unbundled Products 


Some unbundled software products make full use of native-language keyboards, 
while others will add national language support in future releases. The following 
lists show the status of major software products at the current time. 


Initial testing indicates that the following products provide full national language 
support when used with native language keyboards. Note that in most compilers, 
extended characters may not be used in variable names. 


FORTRAN 1.2 
C 1.0 

DeskSet 1.0 
IR 6.0 
MCP 6.0 

SunNet Manager 1.0 


Pascal 2.0 
C++ 2.0 
SunGKS 3.0 
HSI 6.0 
FDDI l.Ot 
SunNet License 1.0 


Modula-2 2.1 
X Compilers 3.0 
SunPHIGS 1.1 
DON 6.0 
NSE 1.2t 
Transcript 2.1.1 


tNot supported in SunOS release 4.1.2. 
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News 1.1 on Type-4 
Keyboards 


The following products will correctly recognize any of the national keyboards, 
but will not handle 8-bit characters. Behavior when an accented character is 
typed is unpredictable; some will produce graphics characters and some will 
ignore the keystroke. 


SunWritef/Paint/Draw 1.1 
BSCRJE 6.0 
Local 3270 6.1 
X.25 6.0 
SunCobol 1.0 


SunTrac 1.3 
CG3270 6.0 
Channel 7.Of 
OSI 6.0 
SCLisp 3.0 


BSC3270 6.1 
SNA Peer 6.0 
SNA3270 6.1 
MBS 6.0 
NetlSAM l.O.DE 


When News 1.1 was released, Type-4 keyboards did not exist. In order to use 
NeWS 1.1 with a Type-4 keyboard, the following patch is required. The patch 
causes NeWS to treat a Type-4 keyboard as a Type-3. 


$NEWSHOME/lib/NeWS/UI.ps. 

The patch is as follows (context "diff" file): 
cd $NEWSHOME/lib/NeWS 
*** UI.ps- Wed Jan 18 11:49:15 1989 

- UI.ps Tue Mar 7 12:27:00 1989 


*************** 

*** 174,179 **** 

- 174,180 - 

/KB_VT100 1 def 

/KB_SUN2 2 def 

/KB_SUN3 3 def 

+ /KB_SUN4 4 def 

/KB_ASCII 15 def 

/TR_NONE 0 def 

*************** 

*** 699,704 **** 

- 700,708 - 


(NeWS/sunl_keys.ps) run 

} 

KB_SUN3 { 

(NeWS/sun3_keys.ps) run 

} 

+ KB_SUN4 { 

+ (NeWS/sun3_keys.ps) run 

+ } 

/Default { 

V__^ 
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System Configuration 


This chapter explains and outlines some things you can do to improve system 
performance on Desktop and server systems; the chapter is comprised of the fol¬ 
lowing sections: 

• About Kernel Configuration 

• Performance Improvement Hints 

• Device Configuration on Open Boot PROM Systems 

• Customizing the Kernel for a Large Server 

• Disk Layout for Systems with 104MB Disks 

• Booting from IPI Disks on SPARCsystem 600MP Systems 


8.1. About Kernel Why would you want to reconfigure and rebuild your kernel? To save main 

Configuration memory (and improve performance) by specifying precisely what is needed for 

the applications used, and to add any required drivers and modules. 

When you install SunOS 4.LX, you use the large GENERIC kernel by default. 
The GENERIC kernel supports all Sun hardware and software features, including 
many that are probably not necessary for your system. Customizing it or using an 
alternative kernel can significantly reduce memory requirements and improve 
performance. It is highly recommended that you reconfigure the GENERIC ker¬ 
nel as soon as possible after installation. Kernel configuration options are briefly 
described below. For detailed information, see System and Network Administra¬ 
tion. 

There are three basic alternatives to the GENERIC kernel configuration file: 

• Install one of the Sun-supplied preconfigured GENERIC_SMALL kernel 
configuration files as is. This is the simplest alternative, but is likely to save 
less memory than the others. 

You can install a GENERIC_SMALL kernel with the 
install_small_kernel script, which can be run from the miniroot or 
from a shell as superuser. Standalone systems can use the script to install 
their own kernels; servers can use it to install small kernels for their clients. 

• Build a custom kernel using one of the Sun-supplied kernel configuration 
files as a template. 
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• Build a completely customized kernel by editing the GENERIC 

configuration file yourself. This is the most complex of the three alterna¬ 
tives, but may improve performance the most. 


Sun-Supplied Kernel Kernel configuration files are templates that make it easier to customize your 

Configuration Files system’s kernel. The kernel configuration files for a standalone system or the 

kernel architecture of a server are located in: 

/usr/kvm/sys/^-«rc/i/conf 

- k-arch is replaced by a kernel architecture: sun4, sun4c, sun4m 
The kernel configuration files for the clients of a server are in: 

/ exp o r t / exe c / kvm / A:-flrc/z / sy s //:-arc/z / c on f 

- k-arch is replaced by kernel architecture (sun3, sun3x, sun4, sun4c, 
sun4m) 

The tables that follow list the kernel configuration files supplied for each of the 
SPARC kernel architectures. These are in addition to the GENERIC configuration 
files, of course. 


Table 8-1 Sun-Supplied Kernel Configuration Files for sun4c Architectures 


Configuration File Name 

Supported Architecture 

GENERIC_SMALL 

DL60 

NFS60 

DLS60 

SDST60 

Desktop SPARCsystem with up to 8 SCSI Disks, 4 SCSI Tapes, 2 CD-ROM 

Diskless Desktop SPARCsystem (Does not support SCSI Devices) 

Desktop SPARCsystem with up to 8 SCSI Disks, 4 SCSI Tapes, 2 CD-ROM 
Configured to Boot from NFS Filesystems 

Desktop SPARCsystem with one SCSI Disk, Configured to Boot from Network, 
but Use Local Swap 

Desktop SPARCsystem with up to 8 SCSI Disks, 2 SCSI Tapes, 2 CD-ROM 
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Table 8-2 Sun-Supplied Kernel Configuration Files for sun4 Architectures 


Configuration File Name 

Supported Architecture 

GENERIC_SMALL 

Sun-4/110 or 4/330 with up to 4 SCSI Disks and 2 SCSI Tapes 

DL 

Diskless Sun-4/260, 4/280, 4/110, or 4/330 

DLllO 

Diskless Sun-4/110 

DL330 

Diskless Sun-4/330 

SDSTllO 

Sun-4/110 with up to 4 SCSI Disks and 2 SCSI Tapes 

SDST330 

Desktop SPARCsystem with up to 4 SCSI Disks and 2 SCSI Tapes 

XDXT260 

Sun-4/260 with up to 2 SMD-4 Controllers, 2 Xylogics 1/2" Tape Drives, 2 SCSI 
Disks, and 1 SCSI Tape 

XYXT260 

Sun-4/260 with up to 2 Xylogics 540/451 Controllers, 2 Xylogics 1/2" Tape 
Drives, 2 SCSI Disks, and 1 SCSI tape 

IDST390 

Sun-4/390 with 2IPI Controllers with 8 drives each and 4-SCSI tape devices 

IDST490 

Sun-4/490 with 4 IPI Controllers with 8 drives each and 8 SCSI tape devices 

SDST470 

Sun-4/470 with up to 4 SCSI or IPI Controllers, with maximum of 8 drives 
across controllers, 8 SCSI tape devices 


Table 8-3 Sun-Supplied Kernel Configuration Files for sunAm Architecture 


Configuration File Name 

Supported Architecture 

GENERIC_SMALL 

DL 

NFS 

SDST 

IDST 

Sun-4m with up to four users 

Diskless SPARCsystem 600MP 

Sun-4m with SCSI disks and tape; boot from server 

Standalone Sun-4m with SCSI disks and tape 

Sun-4m with IPI disks and SCSI tape 


8.2. Device Configuration The process of rebuilding the kernel of an open boot prom system (sun4c, 

on Open Boot PROM sun4m) is much simpler than for other Sun systems running SunOS 4.1.2. The 

Systems prom monitor for open boot prom, in conjunction with the kernel, eliminates the 

need for most of the device-specification lines in kernel configuration files. 

Standard SunOS kernel configuration files contain many lines describing bus 
connections, controller addresses and slave units on controllers. An open boot 
PROM kernel uses simple declarations for describing devices. For example, in the 
sun4c GENERIC configuration file, the following lines are all that is necessary to 
specify the inclusion of device drivers and kernel support for them; the PROM and 
the kernel auto-configuration code do the rest. 


^sun 

XT microsystems 


Revision A of December 1991 











8-4 SunOS 4.1.2 Release Manual 


device-driver 

sbus 

# 

'driver' for SBus interface 

device-driver 

bwtwo 

# 

monochrome frame buffer 

device-driver 

cgthree 

# 

8 bit color frame buffer 

device-driver 

cgsix 

# 

8 bit accelerated color frame buffer 

device-driver 

dma 

# 

'driver' for dma engine on SBus interface 

device-driver 

esp 

# 

Emulex SCSI interface 

device-driver 

fd 

# 

Floppy disk 

device-driver 

audio 

# 

sound chip 

device-driver 

le 

# 

Lance ethernet 

device-driver 

zs 

# 

UARTs 


The flags word that was formerly used to specify ignoring CARRIER DETECT 
for the z s (uart) driver has been replaced by data in the EEPROM, which the ker¬ 
nel auto-configuration code asks the PROM to fetch. The fields (ttya- 
ignore-cd and ttyb-ignore-cd) may be set either using either the 
eeprom(8S) command, or commands from the PROM monitor (see 
monitor(8S)). 


Declaring SCSI Buses, Disks, The kernel configuration file also declares the SCSI buses, disks, and tapes that 

and Tapes may be connected to the system. This must be user-entered, rather than deter¬ 

mined by auto-configuration, because Sun supports some non-CCS (Command 
Command Set) devices which do not respond to the SCSI inquiry command 
(which would normally determine what kind of a device it is). 

Two steps are involved. The existence of one or two SCSI buses connected to 
the system must be declared, and disks and tapes must be identified and associ¬ 
ated with their bus. 

The following screen shows the entries for declaring a first (scsibusO) and 
second (scsibusl) SCSI bus: 


c 



N 

scsibusO 

at 

esp 


scsibusl 

at 

esp 


V_ 



J 


The disks and tapes associated with a SCSI bus are declared as shown in the fol¬ 
lowing example. The example gives GENERIC kernel configuration file default 
declarations for the first SCSI bus. 


f 

disk 

sdO 

at 

scsibusO 

target 

3 

lun 

0 

# 

first hard SCSI disk 

N 

disk 

sdl 

at 

scsibusO 

target 

1 

lun 

0 

# 

second hard SCSI disk 


disk 

sd2 

at 

scsibusO 

target 

2 

lun 

0 

# 

third hard SCSI disk 


disk 

sd3 

at 

scsibusO 

target 

0 

lun 

0 

# 

fourth hard SCSI disk 


tape 

St 0 

at 

scsibusO 

target 

4 

lun 

0 

# 

first SCSI tape 


tape 

stl 

at 

scsibusO 

target 

5 

lun 

0 

# 

second SCSI tape 


disk 

srO 

at 

scsibusO 

target 

6 

lun 

0 

# 

CD-ROM 

J 
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To be more specific, the first line above says that there may be a disk, sdO, on 
scsibus number 0, at SCSI target address 3, logical unit 0. These declarations 
merely state that this device may be at this location; look for it when booting, and 
(if not found) look again if a program attempts to open it while the system is run¬ 
ning. 

The default declarations in the GENERIC kernel configuration file for disks and 
tapes on a second SCSI bus are: 


f 

disk 

sd4 

at 

scsibusl 

target 

3 

lun 

0 

# 

fifth hard SCSI disk 


disk 

sd5 

at 

scsibusl 

target 

1 

lun 

0 

# 

sixth hard SCSI disk 


disk 

sd6 

at 

scsibusl 

target 

2 

lun 

0 

# 

seventh hard SCSI disk 


disk 

sd7 

at 

scsibusl 

target 

0 

lun 

0 

# 

eighth hard SCSI disk 


tape 

st2 

at 

scsibusl 

target 

4 

lun 

0 

# 

third SCSI tape 


tape 

st3 

at 

scsibusl 

target 

5 

lun 

0 

# 

fourth SCSI tape 


disk 

V_ 

srl 

at 

scsibusl 

target 

6 

lun 

0 

# 

second CD-ROM device 



The default declarations for a third and fourth SCSI bus can be found in the 
GENERIC kernel configuration file for your Sun-4c or Sun-4m system: 

/usr/sys/sun4c/conf/GENERIC 
/usr/sys/sun4m/conf/GENERIC 


Booting from IPI Disks on If you intend to boot or reboot a 4.1.2 based Sun-4m system from an IPI disk 

SPARCsystem 600MP device, you must make sure that certain "pseudo" device drivers are included in 

Systems the kernel configuration file, in addition to the standard ipi, is, idc, id, and 

ipibus configuration information that is required to include device driver sup¬ 
port for the IPI disk devices. 

The additional pn, ipi sc, and idpseudo devices, which are included in the 
standard Sun-4m GENERIC configuration file, interract with the open boot PROM 
at boot and reboot time to obtain and provide self-identifying information. The 
following entries must be in the kernel configuration file: 





>1 

device-driver 

pn 

# 

Self-ident. VME/IPI pseudo driver 

device-driver 

ipisc 

# 

Self-ident. IPI-3 Slave Cntrl pseudo driver 

device-driver 

idpseudo 

# 

IPI Disk pseudo device driver 




_/ 


If you are not using the GENERIC kernel, or if you have removed the above lines 
from the GENERIC kernel, be sure to include the lines in the kernel configuration 
file before making a new kernel. 
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8.3. Customizing the On large servers it may be necessary to adjust two basic parameters in the kernel 

Kernel for a Large configuration file: 

Server 

• maxusers 

• number of ports (for systems with ALM-2’s) 


Maximum maxusers Values For best performance, you want to set the maxusers value in the kernel 
for Sun-4, Sun-4c, Sun-4m configuration file to a high value. Use the formula described below to determine 

Servers the maxusers value, but be aware of the following limitations; if you exceed 

these values, your kernel may not boot. 


Table 8-4 Maximum maxusers Values for Sun-4, Sun-4c, Sun-4m 


Architecture 

64MB RAM or less 

128MB RAM 

640MB RAM 

2.5GB RAM 

sun4 

225 

225 

NA 

NA 

sun4c 

225 

225 

NA 

NA 

sun4m 

185 

180 

155 

45 


Note that the maximum maxusers value for a SPARCsystem 600MP system is 
between 45 and 185, depending on the system configuration — the more 
memory, the lower the maxusers value. These maxusers values correspond 
to 1024 and 3253 processes, respectively. 

The GENERIC kernel configuration file in the directory /usr/kvm/sys/A:- 
arch/conf sets a default value for maxusers that is too small for large 
servers, and is more suitable for personal-use workstations. Check the file for 
the line 


f 



maxusers 

maxusers _value 


V 




Formula for Determining 
maxusers 


and, if necessary, increase maxusers_value to reflect the actual load on the server. 
The number of streams allocated is based on this number, so for proper alloca¬ 
tion, any getty’s running on serial ports should be considered active sessions, 
and if any lines are running both dial-in and dial-out service via the upper 128 
minor numbers, the dial-out should be considered an additional user. 

The calculation of maxusers is generally: 
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number of framebuffer sessions (i.e,, windows and other tools, 
or one for a non window login on the console), 

plus 

number of network sessions (telnet, ftp, rsh, and 
r log in sessions to or from this host) 

plus 

number of serial ports with ge tty’s running on them, 

plus 

maximum number of concurrent dialout (tip and uucp) 
sessions. 

Then add a few, and round the figure upward, because you will probably underes¬ 
timate, and the cost of the extra kernel size is not much when you have large 
memories (32 MB and up) and disks (600 MB and up). In general, systems with 
eight ALM-2 boards will also tend to have larger physical memories and larger, 
faster disks, so setting maxusers on the high side is usually preferable to setting it 
too low. See limits on maxusers size in the table above, however. 


Adjust Number of ALM-2 In the kernel configuration file, the line 

Ports __ 




pseudo-device mcpa64 


V_ 

7 


needs to be adjusted to include all ALM-2 serial ports that are likely to be used 
(if you have no ALM-2’s, you can delete the line or comment it out). For any 
kernel that is expected to support any of the upper four ALM-2 boards (mcp4 
through mcp7), this line should be changed to 


r 


pseudo-device mcpal28 


\ 

7 


to provide async protocol support for the whole set. Note that if you use a higher 
numbered ALM, then the mcpa number must be great enough to handle that 
ALM and all lower numbered boards, installed or not. 

Create /dev Entries When adding ALM-2’s, you must create the /dev entries, as follows: 




# cd /dev 


# MAKEDEV mcpO mcpl mcp2 .. . 


V .. .. . 

7 


where an mcpu entry is specified for each ALM-2, up to a max of mcp7. The 
/ dev entries created by this command are the names which must be entered into 

/etc/ttytab. 
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Make Entries in Y ou will have to manually make entries in the / e t c /11y t ab file. See the 

/etc/tty tab System & Network Administration manual, Section 11.3, “Adding a Terminal to 

your System.” 

The procedure for adding tty ports: 

1. Determine the total number of logins to be supported. 

2. Apply the algorithm described above for computing maxusers. 

3. Rebuild the kernel, if required. 

4. Make entries in / dev for the new tty ports. 

Do this with /dev/MAKEDEV. Each argument to makedev represents one 
peripheral board, e.g., “makedev mcpO” means make all tty port entries 
(16) for the first ALM-2, “makedev mcp7” means make all tty port 
entries (16) for the 8th ALM-2 board. 

5. Make entries in / et c /1 ty t ab for each tty port. The format is shown in 
System & Network Administration, section 11.3. 


Sample /etc/ttytab entries: 


ttyhO 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhl 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh2 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh3 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh4 

" /usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhS 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh6 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh7 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhS 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyh9 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyha 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhb 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhc 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhd 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhe 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyhf 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 

ttyiO 

"/usr/etc/getty 

std.9600" 

unknown 

on 

secure 


Possible Error Messages If too many /etc/ttytab terminals are enabled, or too many remote logins 

occur, compared to the maxusers setting in the con fig file, the message 



may be displayed on the console and in the /usr/adm/messages log. This is 
an indication that you should increase the maxusers value, and re-build the 
kernel. 


After configuring, building, and booting the new kernel, start up the system and 
run it for a while. Any messages relating to exhaustion of streams resources are a 
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red flag that you may need to refigure the correct value for maxusers. 

Monitoring Performance Monitor long term performance with nets tat -m, and reduce resource allo¬ 

cations if it is shown that peak allocations never get near the allocated maxima. 
You will want to do this re-allocation of resources if the performance of the 
machine is suffering due to lots of memory being hogged by the kernel — espe¬ 
cially if the cost of reconfiguring the kernel is low (low impact on users). 

Bear in mind that allocation of data buffer resources may start to fail when the 
high water mark reaches 80% of the configured maximum, as the system tries to 
reserve some resources for high priority messages. No matter how careful you 
are to watch the resources, you always need some extra room, so don’t tune your 
system too tightly; tune it so that the observed maximum numbers are between 
50% and 75% of the absolute limit values in your kernel configuration file. 


8.4. Performance Consider the following ideas for improving performance. 

Improvement Hints 

Use the tmpf s Filesystem The tmpf s filesystem allows a system’s virtual memory resources to be used as 

a filesystem. Files and directories can be created and deleted with normal UNIX 
semantics. The tmpf s filesystem does not require additional disk space and 
allows data to be accessed quickly, tmpf s-mounted directories appear identical 
to standard UNIX filesystems to users and most UNIX utilities. 

For details on using the tmpf s filesystem, see the System and Network Adminis¬ 
tration manual and the tmpf s(4S) man page. 



The tmpf s filesystem is commonly used to improve the performance of the 
/ tmp directory. However, note that unmounting / tmpf s or rebooting your sys¬ 
tem removes all files under / tmpf s, including those in subdirectories. 


Use Static Routing When Workstations that have only one Ethernet interface and do not act as NFS servers 

Possible can do static routing, rather than dynamic routing with in. routed. 

To institute static routing, “comment out” (place a “#” in front of) lines in your 
/etc/rc. local file so that they appear as shown: 




\ 

#if 

[ -f /usr/etc/in.routed ]; then 


# 

in.routed; echo -n ' routed' 


#fi 



V 




Routing table entries will still be added or modified by the kernel as a result of 
ICMP redirect messages. 

Diskless clients have a route provided automatically by the server. On other 
workstations, a command of this form can be added to rc . local just after the 
in. routed information: 
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/usr/etc/route add default router 1 

V_ J 


This action frees up both the pages used by in. routed and most of the 
memory allocated for routing table entries. 


Do Not Enable Process Accounting is not enabled unless it is configured into the kernel (options 

Accounting SYSACCT) or there is a /var/adm/acct directory when your system boots. 

See the man page for rc(8) for more information. 


Eliminate Unnecessary Server Workstations typically only require the following server processes: 

Processes 

• portmap 

• ypbind 

• b i o d (four processes) 

• syslogd 

• update 

• inetd 

• Ipd 

• sendmail 

• key serv (if you use secure NFS) 

Eliminating any additional server processes will increase performance. 

Initially, the default is for file-system quotas not to be enabled. If quotas have 
been enabled, replace /usr/ucb/quota with /usr/bin/true. This will 
prevent possible delays at login time due to calls to rpc . rquotad on each 
NFS server from which you have a file system mounted. 

Two procedures are described in this section: 

• Desktop SPARCsystem with Two 104MB Disks: Using Second Disk for 
/home and Additional Swap Space 

• Desktop SPARCsystem with Two 104MB Disks: Using Second Disk for 
OpenWindows 

This section describes how to set up a /home filesystem on the g partition of 
your second disk and how to use your second disk for added swap space. Note 
that you cannot use sdlg for both /home, as described here, and for OpenWin¬ 
dows, as described in section 8.5.4 below; you must choose between one use or 
the other. 


Do Not Enable File-System 
Quotas 


8.5. Disk Layout for 

Systems with 104MB 
Disks 


Desktop SPARCsystem with 
Two 104MB Disks: Using 
Second Disk for /home and 
Additional Swap Space 


A sun 
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A Desktop SPARCsystem with preinstalled SunOS 4.1.2 on a 104 megabyte disk 
does not have a separate /home filesystem for local text and data files, “home” 
files are maintained in subdirectories of the /usr filesystem, which they share 
with unbundled and third-party application software. What may appear online as 
a separate /home filesystem is really a “symbolic link” to files in 
/usr/export/home. 

If you use space on a second disk as a /home filesystem, more space is available 
for application software on the first disk and for local user files on the second 
disk. 

You may need to use your second disk to provide extra swap space; consider this 
if you start getting the following error message: 

Not Enough Memory 

when you start up a program. In many cases, additional swap space improves 
system performance, even without an initial shortage. 


Using the g Partition on Your 
Second Disk as /home 


To use the g partition of your second disk as /home: 

1. Asa precaution, if there are files in /usr/export /home on your first 
disk, use dump(8) to make backup copies. 

2. Become superuser and create a new filesystem in partition g on your second 
disk: 


-^----- .> . . : ■ — — \ 

%su 

#newfs /dev/rsdlg 

C _ : _ . ^_ J 


3. Create an entry in your /etc/fstab file so that the new filesystem is 
automatically mounted as /home when you boot your system: 


#/dev/sdlg /home 4.2 rw 1 3 

A 


) 


4. If you have user accounts and files in /usr/export / home, transfer them 
to the g partition of your second disk: 


( 

> 

ttmount /dev/sdlg /mnt 

#cd /usr/export/home; tar cfh - . 

(cd /mnt; tar xpf -) 

V. . 

y 


5. List the files copied to the new filesystem to make sure the transfer took 
place correctly: 


. ■ -----—------ 

>> 

#ls -IR /mnt 


V_^___' _____ : 

y 


6. If the files were copied to /mnt as desired, you can now remove them from 
/usr/export / home, freeing the space they occupied for other software: 
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#rm -rf /usr/export/home/* 

V_____ 


7. Remove /home as a link to /usr/home and create a new /home direc¬ 
tory as a mount point for the /home filesystem on the second disk: 


#rm /home 
#mkdir /home 

V_:_■; iv;;- '.i-.ivfiii-v-rv-- J 


8. Mount the /home filesystem on your second disk on the /home directory 
of your first disk: 


/ 

#mount /home 




V 



J 


The procedure given above is an easy way to set up a home filesystem on your 
second disk. It is possible to move other filesystems to your second disk, to 
change the sizes of the given partitions, and to use partitions other than g for 
/home. For further information on this, see System and Network Administration 
and Installing SunOS System Software. 


Using Your Second Disk for 
Added Swap Space 


To use the b partition of your second disk for additional swap space: 

1. Become superuser and create an entry in your /etc/fstab file so that 
whenever you boot, the b partition of your second disk is automatically 
mounted for use as swap space in addition to the swap space on your first 
disk. The entry for your f stab file is: 


f 


/dev/sdlb sv^ap swap rw 0 0 


V _ 

J 


2. To turn swapping from your second disk on, su to root and type: 




#swapon -a 


V ___ 

J 


On your second disk, you can use partitions other than b for swap space. To do 
so, replace sdlb in the preceding steps with sdl and the name of the partition 
you want to use for swap. 


Desktop SPARCsystem with 
Two 104MB Disks: Using 
Second Disk for 
OpenWindows 


If you use the first 104MB disk of a Desktop SPARCsystem as the system disk 
for SunOS 4.1.2 release software, there will not be enough room for OpenWin¬ 
dows. This section describes how to use the g partition of your second disk 
(sdlg) for OpenWindows. 

If you put OpenWindows in sdlg, you will have about 21MB of space in /usr 
on your first disk for use by /home. 
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Experienced users who want to have more options in using their second disk 
should refer to the System and Network Administration manual, which provides 
detailed information on disk partitioning, mounting partitions, and using sym¬ 
bolic links. 

Note that you cannot use sdlg for both /home, as described above, and for 
OpenWindows, as described below; you must choose between one use or the 
other. 

The procedures you need to follow in using sdlg for OpenWindows depend on 
whether or not you use Suninstall to install SunOS 4.1.2 release software. 

If You Use Suninstall If you use Suninstall, you can set up a /usr / openwin filesystem in sdlg 

from the start; see Installing SunOS System Software for instructions on setting 
up file systems on a second disk. After using Suninstall you can load OpenWin¬ 
dows in sdlg by following the instructions given in the section “Installing the 
OpenWindows Software in sdlg,” below.* 

If you have the preinstalled version of SunOS 4.1.2 on your first disk or you use 
re-preinstall or Quick Install, you will need to create a /usr/openwin filesys¬ 
tem in sdlg and carry out additional steps before your can load OpenWindows 
into sdlg. 


Systems with SunOS 4.1.X 
through Preinstallation, 

Quick Install, or Re-preinstall 


To use the g partition of your second disk for OpenWindows: 

1. Become superuser (you will need to be superuser for the remaining steps) 
and create a new filesystem in sdlg. This will be your OpenWindows 
filesystem. 

- 

Password: lenterro 0 tjpassword'i 

#i»ewfs 

/dev/rsdl 0 ; 160230 sectors is 763 cylinders of 6 tracks, 35 sectors 
82.0MB in 48 cyl groups (16 c/g, 1.72MB/g, 768 i/g) 
super-block backups (for fsck -b #) at: 

32. 3440, 6848, 10256, 13664, 17072, 20480, 23888, 26912, [etc.] 

V. . ./ 

Note: Sample display; contents may vary, depending on user input and the system used. 

2. Use f sck to check the new filesystem: 


* Do not try to load OpenWindows into sdlg with Suninstall. Suninstall will balk, with the message that there 
is insufficient space. 
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... ..: ;• • ||||| | |||:j g ......... .. 

#£so}c /dtev/rsdlg 

** /dev/rsdlg 
** Last Mounted on 
** Fl^ee 1 - Check Slocks and Sizes 
** Fhase 2 -* Check Pathnames 
** Phase 3 - Cheek Ctmneetlvity 
Phase 4 * Check Eefereacfe Counts 
** Phase 5 ~ Check Cyl groups 

2 files, $ used, 74713 free (17 frags, 9337 Mocks, 0.0% fragmentation) 

I_ 


3. Transfer the contents of /usr/openwin on your first disk to your new 
filesystem in sdlg. These contents, subdirectories and symbolic links for 
use by Open Windows, were preinstalled or set up when you used Quick 
Install or re- preinstall. 


/"- 



#mount /dev/sdlg 



#cd /usr/openwin 



#tar cfh - . 1 ( 

cd /nmt; tar 3ip£ - ) 

1 

1 




4. Make sure the transfer was carried out correctly; compare the contents of 
/usr/openwin and sdlg: 


^.... 






#ls -F 

/usr/openwin 





bin/ 

etc@ 

lib/ 

man® 

sys/ 


demo/ 

include® 


share/ 



#ls -P 

/mat 


S h % 4 



bin/ 

etc® 



sys/ 


demo/ 

include® 

local/ 

share/ 



Vi:-::; 







5. If the contents matched, remove the contents of /usr/openwin from 
/usr on your first disk: 



1 « W 

#na ~rf /usr/openwin/* 



—————^ 


6. Edit your /etc / f stab file so that your OpenWindows filesystem on 
sdlg is automatically mounted as /usr/openwin whenever you boot 
your system. Edit /etc/fstab and add the line: 


-— . 

/dev/sdlg /usr/openwin 4.2 rw 1 2 
--^ 


7. Mount sdlg on /usr/openwin: 




#mount /usr/openwin 





.aSSSU ^ -m-m 
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Installing OpenWindows 
Software in sdlg 


You are now ready to load the OpenWindows software. The remaining steps are 
the same as those for systems that defined the /usr/openwin partition using 
Suninstall. 


To install OpenWindows in the filesystem you created in sdlg, change direc¬ 
tories to /usr and use the new extract_f iles(8) command to load the 
OpenWindows software categories from your SunOS 4.1.1 release media.* You 
must be superuser to use extract_f lies. 


.. 

#cd /usr 

#/usr/etc/install/extract_£iles srO QpenWlndows.Users 
#/usr/etc/ixistall/«Ktraot_£llds srO 
#/usr/etc/iiistalI/extract-„files srO OpenWindows_Foiits 
#/u8r/atc/inatall/«actract_files srO OpenWiudows^Frograxoiitars 

V,___ . _ ___> 


Note that you do not need to load OpenWindows_Programmers unless you 
plan to develop window-based applications that will run in an OpenWindows 
environment. 


* In addition to the man page for extract_f iles, see Chapter 2 for information on using 
extract_files. 
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Part 4 — Open Issues 


Part 4, which is found in a package on top of the release binder in the Release 
Minibox, is comprised of two important chapters: 

• Late-Breaking News 

• Known Problems 

Be sure to insert the Open Issues package (Part Number 800-6643-10) into the 
binder and to read the two chapters before proceeding with the installation of 
SunOS 4.1.2. 



























Part 4 — Open Issues — Continued 





SunOS 4.1.2 Open Issues 


This package contains important information for the SunOS 4.1.2 Release Manual. Insert the attached 
material in the Release binder, behind the Open Issues tab. 


Sun Microsystems, Inc. • 2550 Garcia Avenue • Mountain View, CA 94043 • 415-960-1300 


Part No: 800-6643-10 
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Part 4 — Open Issues 


Part 4, which is found in a package on top of the release binder in the Release 
Minibox, is comprised of two important chapters: 

• Late-Breaking News 

This chapter includes warnings about patch installations, lists of additional 
bug fixes and patches, documentation changes, and ergonomics comphance 
standards for German installations. 

• Known Problems 

This chapter includes lists and descriptions of bugs in SunOS and OpenWin- 
dows Versions 2 and 3. 

Be sure to insert this Open Issues package into the binder behind the tab for Part 
4 and to read the two chapters before proceeding with the installation of SunOS 
4.1.2. 


Part 4 — Open Issues — Continued 





Late-Breaking News 


This chapter provides the latest news about the PCS version of SunOS 4.1.2, 
dated December 1991. This chapter includes the following sections: 

• Warnings about Patch Installations 

• Additional Bugs Fixed and Patches Added 

• Additional CTE Escalations Fixed in SunOS 4.1.2 

• Release Manual Documentation Changes and Additions 

• Sunupgrade Workarounds and Documentation Changes 

• Ergonomics Compliance (Germany) 

• Ergonomievorschriften (German-language version) 

If you are going to use sunupgrade to upgrade to SunOS 4.1.2, be sure to read 
Section 9.5 before starting the upgrade. 

See Chapter 10 for listings and descriptions of known problems with the release. 


9.1. Warnings about Patch 
Installations 


Do not install a patch unless you are sure the patch is compatible with the 
currently-installed release. 


Do Not Install Sun IPX 
Supplement 



This patch has been incorporated in the OpenWindows Version 2 included with 
SunOS 4.1.2; the patch is unnecessary and may cause system problems if it is 
installed on top of SunOS 4.1.2. Do not install it. 


Do Not Install Sun 1.3GB Disk A special patch was provided for Sun-4 systems running SunOS 4.1.1 and Sun-4c 

Enhancement systems running SunOS 4.1.1 Rev B, to enable use of the 1.3GB disk on these 

systems. The changes have been incorporated in SunOS 4.1.2; the patch is 
unnecessary. Do not install it. 
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9.2. Additional Bugs Fixed 
and Patches Added 


The following bugs were fixed and CTE patches added since the SunOS 4.1.2 
Release Manual went to press. 


Kernel Bugs Fixed 1047696: Panic when trying to install software on Sun-4c with 40MB or more of 

memory; hatjpmgreserve error. 

1068363: SPARC 2 system crashes with maxusers greater than 83. 


Network Bugs Fixed 1065361: Wrong gid for existing file created again. 

1045211/1042491: Some network services invoked by inetd may fail to run. 


Linker-loader Bugs Fixed 


1070559: Id. so exhausts swap space with some shared libraries. 


Graphics Bugs Fixed 


1071121: GT crashes when picking PHIGS solids with front face culling 
enabled. 


Library 


1052558: System call should do a vfork, not a fork. 


New Patches Available (Bugs Patches are available for the following bugs through your local Sun Answer 
1074337,1073234) Center if your system is under warranty or if you have a support contract: 

• Bug: 1074337: When formatting disks on Sun-4s, if the defect list happens 
to be large enough to require two disk blocks, you may get a format failure: 

( 1 

formatting... done 

assertion failed: file 'ctlr_scsi.c', line 2331 
V_ ) 


See the description of the bug in Section 10.2 for more detail. 

• Bug: 1073234: mmap system call fails on Sun-4m for data fetch of nonex¬ 
istent device memory address. See the description of the bug in Section 10.2 
for more detail. 


9.3. Additional CTE 
Escalations Fixed in 
SunOS 4.1.2 

Patch 100244-02 [roll from 100244-01] 

1033287 Frequent exhaustion of chanmap resource observed 

Patch 100356-01 [new] 

1067615 Kernel hangs while processing aiocancel system call. 


In addition to the Corporate Technical Escalation (CTE) patches listed in Section 
6.13 of the Release Manual, the following CTEs were also fixed in SunOS 4.1.2. 
The patch ID is followed by a list of the bugs fixed by the patch, with brief 
descriptions. 
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Patch 100364-01 [new] 

1029802 4/280 with xy 4 51 panics: registerss accessed while busy. 

Patch 100346-01 [new] 

1044722 Undefined symbol in 1 ibxpg. a. 

Patch 100357-01 [new] 

1066663 SIGIO signal for async lO fails to pend across NFS. 

Patch 100173-06 [roll from 100173-04] 

1066287 NFS hang when looking at large file being changed on server. 
1064433 Export of subtree doesn’t work 

1045536 NFS exports to non-Sun system can result in file truncation. 

Patch 100305-06 

1063772 Possible to overwrite any file on system using Ipr. 

1058003 Reading from /dev/printer, Ipd doesn’t check how much data 
it has read 

1016437 Ipd does not check file names for legafity. 

1040453 Ipd can be used by any user to delete any file on the system. 


9.4. Release Manual 
Documentation 
Changes and Additions 


Open Windows Version 2 CTE The CTE OpenWindows Version 2 patches listed in Section 6.14 of the Release 

Patches: Bugs Not Fixed in Manual are available through your local Sun Answer Center if your system is 

SunOS 4.1.2 under waiTanty or if you have a support contract; the bugs corresponding to these 

patches were not fixed in SunOS 4.1.2. 


Corrections to List of CTE Patch ID 100173 is incorporated at the -06 level — not the -03 level; it is listed at 

Patches Fixed in SunOS 4.1.2 both levels. 

Patch ID 100174 is incorporated at the -03 level — not the -01 level. 

Patch ID 100199 is incorporated at the -02 level — not the -01 level. 


Location of New Commands The new SPARCsystem 600MP commands, mps and mpstat, described in 

mps and mpstat Chapter 2 of the Release Manual, are only available for MP systems; they are 

found in /usr/kvm. 
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9.5. Sunupgrade 

Workarounds and 

Documentation 

Changes 

Change Time Zone Before 
Running check_j)erm 


Unless you are in the US/Pacific time zone, you should set the time zone to 
US/Pacific before running check_perm; if you don’t, SunOS 4.1.1 files that 
you have not changed since installation will be flagged as changed and included 
in /usr/tmp/volatile_f ile. If you then use 

/usr/tmp/volatile_f ile as your volatile file list, all those files will be 
saved with .411 tags. 

A simple workaround for this problem is to execute one of the following com¬ 
mands, depending on whether you are running the C shell or Bourne shell. Since 
you run the commands in a sub-shell, your time zone will not be permanently 
reset. 

csh example: 

# (setenv TZ US/Pacific; check_j>erm {checkj)erm arguments}) 

V ___ ^. . . - ■ ■■ _ ■ • ■■■ ■ ’ '■ :.■■ J 


sh example: 

# (expoxrb TZ; TZ^US/Pacific; check^erm {checkj)erm arguments}) 


Note that the file /etc/uucp/Systems is replaced during sunupgrade. If 
you wish to preserve your current version of the file, you will have to copy or 
move it before running sunupgrade, or you could add 
/etc/uucp/Systems to your own volatile file list and use it instead of the 
default list, volatile_list. 

Alternatively, if you run check_perm, the file will be included in 
/usr/tmp/volatile_f ile, which can then be used when running sunup¬ 
grade. A backup copy of /etc/uucp/Systems will then be saved, with a 
.411 suffix. 

If You Have XNews Server If you have installed the XNews Server patch (100176-08), you may see the fol- 

Patch lowing message during sunupgrade: 

/usr/openwin/bin/xnews won't be upgraded because not 
a regular openwindows server 

_ / 


File /etc/uucp/Systems 
Is Replaced 


This patch, which is not included in SunOS 4.1.2, will not be overwritten by 
sunupgrade. The rest of the OpenWindows package will be upgraded. 
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Installation Manual: On page 2-9 (step 15) and 2-13 (step 16) of Installing SunOS 4.1.2 System 

Upgrade; Rebuild Kernel Software the following note should be added to the last sentence of the last para- 

Before Reboot graph of the step: 

“If you customize your kernel configuration file, you will have to rebuild and 
install the new kernel before rebooting.” 

It is assumed that you ran shutdown before starting sunup grade, as 
described in the instructions; sunupgrade checks to see if /etc/utmp is 
empty before starting the upgrade. If it is not empty, an error message indicating 
that you are running in multi-user mode will be displayed and sunupgrade 
will exit. You will have to zero out /etc/utmp or boot multi-user and run 
shutdown before running sunupgrade. 

Installation Manual: In step 3 of the instructions for remote upgrades, you are told that you may have 

Upgrade; Remote Upgrade to start rpc .mount d manually. You may also have to start nfsd. Seethe 

Needs nfsd mountd(8c) and biod(8) man pages for details. 


Installation Manual: 
Upgrade; Multi-user Error 
Message 
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9.6. Ergonomics 
Compliance 


German Ergonomics 
Standard 


Using SunView with 16- and 
17-Inch Monitors 


Shelltool Support for 
International Keyboards 


Note that this section is included in both Enghsh- and German-language ver¬ 
sions; the German version follows the English version. 


To comply with the German ZHl/618 ergonomics standard, you must use the 
Graphical User Interface available under SunView. The OPEN LOOK Graphical 
User Interface does not comply with the standard. 

To comply with the ZHl/618 standard, the display character height must be at 
least 2.6 mm. SunView complies with the standard on 19-inch monitors, but you 
must change the SunView default font size on 16- and 17-inch monitors. To 
change the default font size for SunView, complete the following procedure. 

1. Start SunView. 


2. Start the Defaults Editor program from the SunView menu or from a com¬ 
mand tool or shell tool by typing: 


f . . . ■ 

, 

% defaulbsddi'b & 


V 

.: ^ ■ J 


3. In the SunView defaults category, change the Font default to: 

: 

/usr/lib/fonts/fixedwidthfonts/screen.r.16 
'---/ 


4. Save your edits and quit the Defaults Editor. 

5. Exit and restart SunView, 

The new font size will now be used to display text. 

To use the shelltool (in SunView or OpenWindows) with non-ASCn characters 
generated by non-U. S. keyboards or characters generated with the Compose key 
of any keyboard, you must edit the shell initialization file to enable an 8-bit data 
path. To use the shelltool (in SunView or OpenWindows) with non- ASCII char¬ 
acters generated by non-U.S. keyboards or characters generated with the Com¬ 
pose key of any keyboard, you must edit the shell initialization file to enable an 
8-bit data path. 

To enable the non-ASCn characters in a shelltool: 

1. Type env in a command window to determine the shell you are running. 

If SHELL=/bin/csh is displayed, you are running the C shell, so you 
should edit your . cshrc file. 

If SHELL=/bin/sh is displayed, you are running the Bourne shell, so you 
should edit your .profile file. 

2. Edit the shell initialization file. 
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Edit your . cshrc file if you are running the C shell, or edit . profile file 
if you are running the Bourne shell. These files are in your home directory. 
To change to your home directory, type cd and press Return. You can use 
any text editor to edit these files. 


In the .cshrc file, add these two lines at the beginning of the file; 


f 


setenv LC_CTYPE iso_8859_l 


stty pass8 



J 


In the .profile file, add these two lines at the beginning of the file: 


r 


LC CTYPE=iso 8859 1; export LC CTYPE 


stty pass8 


V_ 



Changes to the .cshrc and .profile files will take effect in subsequent 
shelltools; or you can "source" these files in existing shelltools by typing 
source and the name of the file. 


This example enables the non-ASCII characters in a C shell: 


c . 


% env 


{list of environment variables...) 


SHELL==/bin/csh {this is a C shell) 


% cd 


% vi ,cshrc 


{add lines from Step 2) 


% source .cshrc 


% 


V, . 

J 
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9.7. Ergonomievorschriften 


Deutsche Ergonomie-Norm Um die deutsche Ergonomie-Norai ZHl/618 zu erfiillen, mu6 die unter SunView 

bereitgestellte grafische Benutzeroberflache verwendet werden. Die grafische 
Benutzeroberflache OPEN LOOK entspricht dieser Norm nicht. 

Verwendung von SunView bei IJm der Norm ZHl/618 zu entsprechen, mu6 die Zeichenhohe mindestens 2,6 
16- and 17-Zoll-Monitoren mm betragen. SunView erfullt diese Bedingung bei 19-Zoll-Monitoren, jedoch 

mu6 bei 16- und 17-Zoll- Monitoren die SunView-StandardschriftgroBe erst 
geandert werden. Mit der folgenden Vorgehensweise kann die SunView- 
StandardschriftgroBe angepaBt werden: 

1. Starten Sie SunView. 


2. W^en Sie aus dem SunView-Menii das Programm “Defaults Editor” oder 
geben Sie bei einem Command Tool oder Shelltool folgendes ein: 


, - 


% defaultsedih & 


V . . . ■ • 



3. Andera Sie in der SunView-Standardkategorie die vorgegebene Schriftart 
(“Font”) wie folgt: 

- 

/usr/lib/fonts/fixedwidthfonts/screen.r.16 
V_ ) 


4. Speicheni Sie die Anderung und beenden Sie den “Defaults Editor”. 

5. Verlassen Sie SunView und starten Sie es neu. 

Fur die Textanzeige wird jetzt die neue SchriftgroBe verwendet. 


Shelltool fiir internationale Um das Shelltool (in SunView oder OpenWindows) in Verbindung mit Nicht- 
Tastaturen ASCII-Zeichen, die mit Tastaturen aus anderen Landem als den USA erzeugt wur- 

den, Oder Zeichen, die mit der Compose-Taste einer behebigen Tastatur generiert 
wurden, verwenden zu koimen, muB die Shell-Initialisierungsdatei so editiert 
werden, daB ein 8-Bit-Datenpfad freigegeben wird. 

Um die Nicht-ASCn-Zeichen in einem Shelltool freizugeben: 

1. Stellen Sie durch Eingabe von env in einem Befehlsfenster fest, welche 
Shell aktiv ist. 

Wenn SHELL=/bin/csh angezeigt wird, handelt es sich um die C-Shell, 
und Sie sollten Ihre . cshrc-Datei editieren. 

Wenn SHELL=/bin/sh angezeigt wird, ist die Bourne-Shell aktiv, und 
Sie sollten Ihre . prof ile-Datei editieren. 

2. Editieren der Shell-Initialisierungsdatei. 

Editieren Sie Ihre . cshrc-Datei, wenn die C-Shell aktiv ist bzw. Ihre 
. prof ile-Datei, wenn die Bourne-Shell aktiv ist. Diese Dateien befinden 
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Sich in Ihrem Stammverzeichnis. Um zu Ihrem Stammverzeichnis zu 
gelangen, schreiben Sie cd und driicken Sie die RETURN-Taste. Sie konnen 
diese Dateien mit jedem beliebigen Texteditor editieren. 


Fiigen Sie in der . cshrc-Datei die folgenden zwei Zeilen am Anfang der 
Datei ein: 


r 

\ 

setenv LC CTYPE iso_8859_l 


stty pass8 


1 



Fiigen Sie in der . prof ile-Datei die folgenden zwei Zeilen am Anfang 
der Datei ein: 


r 

N 

LC_CTYPE=iso_8859_l; export LC_CTYPE 


stty pass8 


V_ 

J 


Anderungen der . cshrc-Datei bzw. . prof ile-Datei treten bei nachfol- 
gend aktivierten Shelltools in Kraft. Sie konnen die Anderung der Dateien 
jedoch auch bei bereits aktiven Shelltools wirksam machen, indem Sie 
source und den Namen der Datei eingeben. 

Das folgende Beispiel veranschaulicht das Freigeben der Nicht-ASCn- 
Zeichen in einer C-Shell: 




% env 


{Liste der Umgebungsvariablen,..) 


SHELL=/bin/csh {dies ist eine C-Shell) 


% cd 


% vi .cshrc 


{Zeilen von Schritt 2 einfugen) 


% source .cshrc 

. ^ . . ■ ■ . . .. ■ ■ 


V- . 

■ / 
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Known Problems 


This chapter lists known problems with SunOS 4.1.2. Problems and bugs are 
grouped in the following sections: 


• Section 10.1 System Administration 

• Section 10.2 Kernel 

• Section 10.3 Graphics 

• Section 10.4 Network 

• Section 10.5 Utilities 

• Section 10.6 Compiler 

• Section 10.7 Hardware 

• Section 10.8 PROM 

• Section 10.9 Sundiag 

• Section 10.10 Sun 386i 

• Section 10.11 Documentation 

• Section 10.12 CD-ROM 

• Section 10.13 Library 

• Section 10.14 Miscellaneous 

• Section 10.15 OpenWindows Version 2 

• Section 10.16 OpenWindows Version 3 Product Notes 

When available, bug ID numbers are given in parentheses after headings. They 
can be used for referencing problems if you need to contact a Sun Answer Center 
or sales representative. 


10.1. System 

Administration 

Unable to Install Multiple OS 
with Suninstall via Multiple 
CD-ROMs (1042906) 


SunOS software can only be installed from one CD-ROM during Suninstall. If 
you want to install 4.1.2 and 4.1.1 or 4.1 on a machine (to provide Sun-3 support, 
for instance), allocate disk space and use add._services to load the other 
release from CD-ROM, or extract the other release from tape, if available. 
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Full Install Option Under 
Quick Install Does Not Create 
/home Partition on 207MB 
Disks (1044999) 

add_services(8) Requires 
350KB in /usr (1032894) 


Automounter May Cover 
/home on System Mounting 
/home from Local Disk 


4 


If you choose the “Full Install” option under Quick Install to load release 
software on a 207MB disk, /home is created as a symbolic link to 
/usr/export/home in order to make optimal use of disk space. 


If you use add_services to add a client to a server of the same application 
architecture, but of a different kernel architecture, the /usr partition must have 
at least 350KB of available space. This applies to clients and servers running 
under the same release; it is not a problem under multiple releases. The require¬ 
ment results from the fact that the root software category is shared between dif¬ 
ferent architectures of the same release. The existing code assumes that root 
should go into /usr/share, instead of /export/exec. If no space is avail¬ 
able in /usr/share, the system sends an error message such as: 


Not enough space in sdOa 

v_ 


\i your system is using the automounter and you mount the home partition of 
your local disk on /home, the automounter may cover your /home directory 
and prevent you from accessing it. 

The automounter is enabled on most systems by default and uses automounter 
maps (often these are NIS maps) to find file systems and determine mount points. 
The automounter preempts the directories that it uses as mount points so that 
only the file systems it mounts on them are accessible. In most cases, the user’s 
home file system has been entered on an automounter map, and the automounter 
mounts it on the user’s /home directory. A problem can arise if you maintain 
your home file system on a local disk, your home file system is not included on 
an automounter map, and you mount it on your /home directory. In this case, 
the automounter does not know about your home file system, cannot mount it on 
/home, and prevents you from accessing it. 

In order to have access to your home file system, you have to give it a mount 
point that has not been preempted by the automounter. To do this, you can 
become superuser, create a new directory, and mount your home partition on it, 
as in the following example: 


%su 

Password: [ enter root password] 

fmkdir Ivlst/ username 

#mount /dev/sdOh fviar/username 

___ ' _ : . . ^^ _ / 


You can also set up an entry in your /etc/fstab file so that your local home 
file system is automatically mounted whenever your system reboots or you use 
the mount(8) command to invoke your f stab file. (See f stab(5) for infor¬ 
mation on setting up an entry in /etc/fstab.) 

If you have an entry in f stab that mounts your local home file system on 
/home, the automounter will not only prevent you from accessing your file 
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system, it will prevent you from unmounting it so that you can remount it else¬ 
where. In this situation, you need to edit your f stab file so that /home is no 
longer a mount point for your home file system. You must then reboot your sys¬ 
tem; the automounter prevents you from unmounting your local file system from 
/home in any other way. 


If add_client -i Fails, Use 
rm_client Before Retrying 
(1033185) 


If the command add_client -i fails, you must use rm_client to delete 
any clients entered on the failed attempt before using add_c 1 ient - i to re¬ 
enter the same clients. 


add__client Does Not Set Up 
Multiple Hostnames for 
Multiple Ethernets (1017238) 


A server with multiple ethemets will have separate hostnames for each of them. 
The add_client utility only knows the hostname for the first ethernet. As a 
result, diskless clients created on secondary ethemets will only have the host- 
name for the first ethernet and will not be able to boot. To correct this, you must 
manually change the hostname of the first ethernet to the hostname of the client’s 
ethernet in the following files on the server: 

/etc/bootparams 
/ export/root/c/Zent/etc/f stab 

In addition, Suninstall only enters the hostnames of the first two ethemets on a 
server in a client’s /export/root/c//enZ/etc/hosts file. You must manu¬ 
ally enter the hostnames of any additional ethemets. 

If you are using NIS, you will also need to update the bootparams map on the 
NIS server. 


Long Delay before Prompt in 
Remote Install from CD on 


SPARC 390/4X0 System 
(1043209) 


If you install SunOS 4.1.X from a remote CD-ROM on a SPARC 390/4X0 sys¬ 
tem and boot the miniroot, there is a series of prompts up to: 


c - - 

■X 

root file system type (spec 4.2 nfs): 


V 

y 


After you respond to this prompt there is a delay of up to 90 seconds before the 
next prompt while the system polls possible controllers. The delay is due to the 
increased number of controllers and drives supported under SunOS 4.1.1. 
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10.2. Kernel 


Asynchronous I/O Peaks Can The kernel keeps a cache of stacks for kernel LWPs in memory, and grows this 

Hang System (1073679) cache on demand. Since the cache has no upper bounds and never shrinks, it 

grows to accommodate the peak async I/O usage, and keeps that memory forever. 
This can starve the kernel, causing all processes to sleep and the system to hang. 


Disks on esp2 , esp3 , Because disks on esp2, esp3, and esp4 are not seen by miniroot, you can 

esp4 not seen by miniroot only install from SCSI bus 0 or 1. 

(1060701) 


format: Assertion Failure on 
1.3GB Elite Drives on Sun-4 
(1074337) 


When formatting disks on Sun-4s, if the defect list happens to be large enough to 
require two disk blocks, you may get a format failure: 

formatting... done 

assertion failed: file 'ctlr_scsi.c', line 2331 
V_y 


The label is not written on the disk, so subsequent invocations of format will 
indicate the disk as <drive type unknown>. This is due to a problem with 
reads/writes of more than one sector at a time on disks using group 1 commands. 
A patch is available through your local Sun Answer Center if your system is 
under warranty or if you have a support contract. 


mmap System Call Fails on 
Sun-4m for Data Fetch of 
Nonexistent Device Memory 
(1073234) 


Trap does not recognize the Mbus timeout and signal a SIGBUS when a data 
fetch of a nonexistent device memory address is requested; “Unexpected trap” 
error message is displayed. A patch is available through your local Sun Answer 
Center if your system is under warranty or if you have a support contract. 


Start RFS on Both Primary 
and Secondary Servers If 
Both Are in Domain (1028779) 


If an RFS domain has both primary and secondary name servers, you must start 
the primary name server first and then, within one to two minutes, start a secon¬ 
dary server. The password (if there is one) for the primary server must be given 
before the password for the secondary server. 

When the primary server is started it tries to contact a secondary name server, if 
one is listed in the file /usr/nserve/rfmaster. If the secondary server 
isn’t started, or isn’t started in time, the primary server “times out”. 


Large maxusers Parameter 
May Cause System to Panic 
(1038406) 


If the maxusers parameter in the kernel configuration file is set too high, the 
resulting kernel will panic during the system boot sequence with one of the fol¬ 
lowing two messages: 

panic: insufficient virtual space for segu: nproc too big? 
Watchdog Reset! 

V_ 


If this occurs, reboot the system using the generic kernel and make a new custom 
kernel using a smaller maxusers value. The maxusers limit varies. 
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depending on the system and the way its kernel is configured. See “Maximum 
maucusers Values for Sun-4, Sun-4c, Sun-4m Servers” in Section 8.3 of the 
Release Manual for more detailed information. In general, the following 
maxusers values should be safe: 

sun4: 286 
sun4c: 225 
sun4m: 45 to 185 


If you use kadb to debug your system and your console device is one of the tty 
ports, it will hang in respect to UNIX the first time you enter kadb. The system 
remains perfectly usable and can be accessed via the other tty, frame buffers, or 
over the network. However, any UNIX processes attempting I/O to the console 
tty will hang. 

10.3. Graphics 


Using kadb Via tty Port on 
SPARCstation 2 Hangs 
Console tty (1043532) 


Using the Sun View Version of 
the OPEN LOOK Deskset on 
24-Bit Systems 


The SunView version of the OPEN LOOK Deskset displays strange colors and 
other undesired effects when used on a 24-bit frame buffer. This includes the 
TC, GXP and GS systems. We recommend you do not use the SunView version 
of OPEN LOOK Deskset with any of these systems. 


SunPHIGS 1.2 May Not 
Double Buffer Correctly on a 
GS Graphics Accelerator 
(1041918) 


If you are using canvas region workstations in SunPHIGS 1.2 on a GS graphics 
accelerator, one of the workstations may “flash” while another is updated. This 
occurs when an application has been inactive for 30 seconds or more and then 
switches its focus from one canvas region workstation to another. The work¬ 
around is to set the SunView environment variable shown below: 


r 

%setenv PW COPY ON DBL RELEASE 


\ 

" . , ■ ■ ■ , 


This problem has been corrected in SunPHIGS 1.3. 
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10.4. Network 

Second Ethernet Starts Even 
When Not Configured 
(1066220) 



These are harmless messages and can be ignored. To disable these messages, 
edit /etc/rc. boot (save old one) and comment out the following line: 



Subsequent reboots will not show these errors. 


If you have multiple ethemets and only configure the primary ethemet (leO) the 
second ethemet (lei) seems to be started automatically even though there is no 
hostname .lei file. The second Ethernet is not actually started, but it is left 
with the IFF_RUNNING flag set; no IP address is configured onto the interface. 
This has no effect on any other software in the system. You may see the follow¬ 
ing error message during bootup: 


Some Network Services The program inetd(8c) provides an internetwork daemon that invokes network 

Invoked by inetd May Fail services listed in the file /etc/inetd. conf. On rare occasions, the service 

to Run (1045211,1042491) invoked fails to mn. The service most likely to fail is tftpd, which is neces¬ 

sary for booting diskless clients. Two other services that may be affected are 
in. cmsd (OpenWindows Calendar Manager) and in. corns at (Mail Tool). 

If a service invoked by inetd fails to mn, terminate inetd and restart it. To 
terminate inetd: 

1. Get the process ID for inetd: 



The process ID is the first number in the process table that results. In the 
example below, the process ID for inetd is 153. 


% ps 

-uaxl 

grep inetd 




■n 

gavg 

6041 

2.7 5.5 40 

192 

p2 S 

10:54 

0:00 grep inetd 

■ root ’ 

: 

153 

0.0 0.0 56 


? IW 

::OGt: :;1:2;:; 

0: 3 0:::;inetd i 

. ) 


Note: Sample display; contents may vary, depending on user input and the system used. 


2. Become supemser, terminate the process (15 3 in the example), and restart 
inetd: 
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( ^ ^ \ v ■ ■ /; :/ .:?■■■'; :r;: . V,: ; 

% su 

Password: [root password] 

# kill 153 

# /usr/etc/lnetd 


ypinit on Slave Server 
Generates Error Message 
(1029284) 


Running ypinit -s ypmaster on an NIS slave server may generate multiple 
error messages on the screen, among them: 


r - 


RPC Program Not Registered 


V 

J 


The transfer of maps takes place correctly, in spite of the error messages that may 
partially fill the screen. 

You can prevent the error messages by logging in to the master server as root 
and entering ypxf rd to start the master server’s ypxf rd daemon before you 
run ypinit on the slave server. 

You can also prevent the messages from appearing if you have the ypxf rd dae¬ 
mon start automatically when the master server boots. To do this, edit the file 
/etc/rc. local as shown: 


f -——-^ 

if [ -f /usr/etc/ypserv -a -d /var/yp/'domainname' ]; then 

ypserv; echo -n ' ypserv' 

ypxfrd; echo -n ' ypxfrd' 

fi 

V. . ./ 


RFS Mounts on Directories RFS will truncate inode numbers of 64K or greater. If you plan on advertising 

with Inodes Greater Than 64k RFS resources, be sure that the file system to be mounted is not capable of creat- 

Will Fail returning getwd ing inode numbers of 65536 or greater. The maximum possible inode number 

fails : cannot find for a file system can be found by executing df -i and adding the iused and 

if ree values for the file system. 


Internet Domain Name 
Service (DNS) Requires 
Hostnames in 
/etc/hosts. equiv and 
.rhosts 


If you are running NIS in conjunction with DNS and the host is not in your NIS 
map or DNS domain, you must have entries for the hostname in the files 
/etc/hosts.equivand.rhosts. 
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10.5. Utilities 

cpio Will Not Copy Rock Because of a problem with cpio copying files with symbolic links from a Rock 

Ridge Symbolic Links Ridge file system, you may have to use tar (1). 

(1069718) 

Timeout Message for Preinstalled Desktop SPARCsystems and Sun-4 and Sun-4c machines which 

Preinstalled Systems Installed have been installed with the Quickinstall option tosuninstall will display a 
with Quickinstall timeout message when booting: 


f 


ifconfig: rarp: timeout 



J 


The system is attempting to do automatic network configuration, but the network 
is not set up correctly, or the system may not be attached to a network. In the 

latter case, another message will be displayed: 

- 

leO: No carrier - transceiver cable problem? 
_ ) 

Both of these messages can be ignored on the non-networked installation. 

The messages can be helpful when trying to debug Automatic Network 
Configuration. For the “RARP: timeout” message, the system information could 
not be obtained from the NIS database in the hosts, ethers, or bootparams maps. 
The “leO: no carrier” message indicates a problem with the tranceiver cable; it is 
probably not connected or is connected incorrectly. 

If Automatic Network Configuration is not your goal, then the “RARP: timeout” 
message is to be expected. 


If you use the -a option of tunef s(8) to set the maxcont ig parameter for a 
partition, you must set maxcont ig at 7 or less. A value greater than seven 
does not generate an immediate error message, but prevents you from mounting 
the disk partition you specified. When you try to mount the partition, you get an 
error similar to the following: 


maxcontlg Parameter 
Cannot be Set Above Seven 
with tune -a (1043735) 


# mount /dev/sdOa /mnt 

mount: /dev/sdOa on /mnt; I/O error 
mount: giving up on: /mnt 

V ■ ■■ ■■. ■ ■ ■■■: ■ ■ ■■■ ■ ■ : ■ ■ ^ ;■ __ J 
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UUCP Password File Problem As explained below, an interaction between the password file entry for uucp 
at Boot Up and the uucp entry in /etc /rc at bootup may cause the following error mes¬ 

sage: 


-^ 

su: uucico: illegal option — c 

usage: uucico [-xNUM] t-r[0|l]] -sSYSTEM -uUSERID -dSPOOL -iINTERFACE 

I_ 


The, default pas swd entry for uucp is 


f 

uucp:*:4:8::/var/spool/uucppublic: 



J 


When adding uucp logins to the pas swd file, it is common to make uucico 
the login shell. In this case, the pas swd entry for uucp becomes: 


uucp:*:4:8::/var/spool/uucppublic:/usr/lib/uucp/uucico 
v_ 


This becomes a problem in interaction with /etc/rc. The default /etc/rc 
file has the following line, which is executed upon boot up: 


su uucp -c /usr/lib/uucp/uusched & 
_/ 


Normally, the -c option of su would be passed along with the rest of the com¬ 
mand line to the shell. But in this special case the shell is uucico, not 
/bin/sh, which is the default if no other shell is specified. Since uucico 
doesn’t have a -c option, the option fails and thesu: uucico: illegal 
option error message results. 

If you get the error message at boot up, you can remove the uucico field from 
the UUCP’s pas swd entry. However, although this takes care of the problem 
with /etc/rc, it creates a new problem in its place: the absence of the 
uucico field means that remote systems calling in to do uucp transfers will be 
prevented from carrying them out. 


Error Messages During Heavy During heavy IPI disk activity, error messages similar to the one below may 
IPI Disk Activity (1036367) appear. They can be disregarded. 


f --——----- 

Apr 9 13:43:46 muishu vmunix: id003h: block 849694 (849694 abs): 
write: Conditional Success. Data Retry Performed. 
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10.6. Compiler 

SPARC Compiler With SPARC compilers earlier than compiler release 0.0 (in 1990) 

Optimization Level -02 Can optimization level -02 (cc -0 or cc -02) can cause the SPARC assembler 

Produce Incorrect Code to generate incorrect code. In the following C program, the assembler code pro- 

(1031879) duced with level -02 optimization does not test the while loop, which leads to 

an infinite loop. 


int boothowto = 1; 
int 

main () 

{ 

int unit; 


retry: 


if (boothowto & 1) { 
unit = -1; 

while (unit == -1) { 

if (unit != -1) { 

printf("unit = %d when it should be -1!0, 
unit); 
exit (1); 

} 

unit = 0; 

print_unit(&unit); 

} 

} else { 

unit = 0; 
goto retry; 


} 


} 


print_unit(unitp) 

int *unitp; 

{ 

printf("print_unit: unit = %d0, *unitp); 

} 


To prevent the problem, compile with -Q-M specified to the assembler. If you 
are running the assembler directly, this is: 

% as [normal options] -01 

V_^______:_:___ ... 

If the assembling takes place as part of compiling a high-level language, it is: 

- 

% cc [normaloptions] -Qoption as -01 
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10.7. Hardware 


Disk Label of Second 104MB 
Disk on Desktop 
SPARCsystem May Be 
Incorrect (1045344) 


If you get the following message the first time you turn your system on, your 
second 104MB disk has an incorrect disk label. 

sdl at espO target 1 lun 0 

sdl: corrupt label - wrong magic number 

sdl: Vendor 'Quantum', product 'P105SS', 205075 512 byte blocks 

V_ 


To correct the label, carry out the following steps: 

1. Become superuser and use f ormat(8S) to reformat your second disk 
(sdl): 

%su 

Password: {enter root password] 

# format. 

Searching for disks...done 
AVAILABLE DISK SELECTIONS: 

0. sdO at espO slave 24 

sdO: <Quantum ProDrive 105S cyl 974 alt 2 hd 6 sec 35> 

1. sdl at espO slave 8 

sdl: <Quantum ProDrive 105S cyl 974 alt 2 hd 6 sec 35> 
Specify disk (enter its number): 

V___ > 


2. Enter 1 to select your second disk: 


disk type 
partition table 


Specify disk (enter its number): 1 
selecting sdl: <Quantum ProDrive 105S> 

[disk formatted, defect list found] 

FORMAT MENU: 

disk - select a disk 

type - select (define) a 

partition - select (define) a 

current - describe the current disk 

format - format and analyze the disk 

repair - repair a defective sector 

show - translate a disk address 

label - write label to the disk 

analyze - surface analysis 

defect ~ defect list management 

backup - search for backup labels 

quit 

format> 


3. Enter commands as shown in the following sequence of screen prompts and 
user responses: 
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■■ f;ormat>^-defect:;: ' 

D:EFEG'I’i:::l^ENU::r.: . 

defect> commit 

working list was not modified. 

.defeGt> :.quit" 

FORMAT MENU 

format> format 

Ready to format. Formatting cannot be interrupted 

and takes 2 minutes (estimated). Continue? y 

Beginning format. The current time is Fri Oct 26 13;26:43 1990 

Formatting...done 

Verifying media... 

Total of 0 defective blocks repaired. 
format> partition 
PARTITION MENU: 

partition> select 

0. Quantum ProDrive 105S 
1. original sdl 

Specify table (enter its number) [1]: 0 
partition> IcLbel 

Ready to label disk, continue? yes 

partiti:dn>q[uiti:"i-iii:i;i-^:i''i 
i; FORMAT^'MENU:; /i::-;V 

■: 'f:drmat:>iqpaiti-;ii 

# 

L,___^______ ...... '....: : ) 


10.8. PROM 


Long Reset Time on Sun-4m 
(1067283) 


When you install mini root on a SPARCsystem 600MP system, the time 
between copying the miniroot to disk and rebooting the miniroot is 
between 45 and 60 seconds; the screen is blank during this time, which may 
cause you to think something is wrong. 


Problem Redirecting I/O to 
Terminal on SPARCstation 2 
with CG6 Framebuffer 
(1042243) 


If you have a SPARCstation 2 with a CG6 framebuffer, entering tty a io at the 
ok PROM Monitor prompt to redirect I/O to a terminal fails and generates the 
error message: 


Memory address not aligned 

V_ ) 
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Attempting to reboot generates the message: 


f 


panic: data fault 


V 

J 


To redirect I/O to a terminal, you need to enter the following commands at the 
ok PROM Monitor prompt and then power cycle your machine. 


r --——____________-——--- 

ok setenv input-device ttya 
ok setenv output-device ttya 

\ _ . : _ :^ : .. :: . ;:: ___ . _ / 


When your system comes up, the output will be redirected to the terminal. 


Suii-4/330 Cannot Boot 
Miniroot from Internal Disk 
with Some PROMs (1044450) 


The boot PROMs on some Sun-4/330s prevent them from booting the miniroot 
from an internal SCSI disk. The workaround for this is similar to the workaround 
given in the description of bug 1032123 below. The only difference is that in 
Step 3 of the workaround, all occurrences of idOOOb must be replaced with the 
boot address appropriate to your system. 


Some Older Sun-4s and Sun- 
3s May Not Be Able to Boot 
Miniroot under SunOS 4.1.X 


Old boot PROM revisions on some Sun-3 and Sun-4 systems may prevent them 
from booting the miniroot under SunOS 4.I.X. When this occurs, messages 
similar to the following are displayed: 

- 

checksum xxxxxxxx != yyyyyyyyyy 
trying to boot anyway 

Illegal Instruction .... 

Error/doing reset 

V___ 


The, workaround for this is similar to the workaround given in the description of 
bug 1032123 below. The only difference is that in Step 3 of the workaround, all 
occurrences of idOOOb must be replaced with the boot address appropriate to your 
system. 


Bug in Some Boot PROMs 
Prevents munixfrom 
Booting the Miniroot on IPI 
Drives (1032123) 


A bug in SPARCserver 390 boot PROMs earlier than 3.0.3 and in SPARCsystem 
4X0 boot PROMs earlier than 3.0 prevents munix from booting the miniroot on 
IPI drives. 

munix (Memory Unix) is a reduced version of UNIX that runs entirely in RAM 
and contains the format program for formatting and partitioning disks, munix 
is loaded off the release media primarily so that format can be used on disks 
that will contain system data. 

The miniroot is a minimal version of UNIX that is loaded into the swap partition 
of the system disk in order to run Sun In stall. 
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Prior to SunOS 4,1, if you booted munix to run format, you had to boot off 
the release media a second time in order to copy the miniroot to disk and then run 
Sun Install. Now, a script automatically copies the miniroot to disk when 
you quit the format program and allows you to boot the miniroot from disk; 


/- — ■ ^ ' ——— ^ —— “ — 

format> q 

Mini-root installation complete. 

What would you like to do? 

1 - reboot using the just-installed miniroot 

2 - exit into single user shell 


Enter a 1 or 2: 



If you now enter 1 to boot the miniroot from an IPI disk, the PROM bug prevents 
booting and generates one of the following messages: 


f 


checksum xxxxxxxx != yyyyyyyyyy 


trying to boot anyway 


Illegal Instruction .... 


Error/doing reset 


1 

) 


There is a workaround which starts at the point where the screen displays: 


Mini-root installation complete. 

What would you like to do? 

1 - reboot using the just-installed miniroot 

2 - exit into single user shell 
Enter a 1 or 2: 

V_ J 


Carry out the following steps to boot the miniroot and use Suninstall. 


1. 

Halt your system: Press 



(Ll/Stop i-m 


2. 

Enter the command for booting CD-ROM. 


>b 

1 

sd(0,30^1) -asw 

yyj 


A series of screen prompts follows. 

3. Respond to the screen prompts as follows: 
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root file system type (4.2 nfs ): 4.2 

root device (.): idOOOb 

root on idOOOb fstype 4.2 
Boot: vmunix -asw 

root file system type (4.2 nfs ) : 4.2 

[45 second pause] 

root device (.): idOOOb 

swap file system type (spec 4.2 nfs): spec 

swap device (.): idOOOb 

Swapping on root device, ok? y 

v: .^ . ^: ) 

Note: Sample display; contents may vary, depending on user input and the system used. 


Spurious Warning Message 
from IPI Disk Controllers 
(1023347) 


When booting from IPI disks the following message may be displayed: 

vmunix: idcO: ctlr message: 'Warning: bad EEPROM checksum' 

I_. 

The warning is harmless and may be ignored. 


Boot PROMs 3.0 and Higher 
Can Only Boot Off IPI Disk 
Units 0 and 1 (1037179) 


A boot PROM bug in PROMs 3.0 and higher limits booting to IPI disk units 0 and 
1. In combination with the following bug, this restricts systems to installing 
SunOS on either idOOO or idOOl. 


Installing mini root on 
idOlO or Higher Causes 
Invalid Boot String (1069384) 


After installing the mini root on any disk ID higher than id007 (idOlO, for 
example), an invalid boot string is generated; if you attempt to reboot using the 
just-installed miniroot, the boot will be attempted from id (0,2 8,1) 
instead of the correct id (1, 0,1) . 


CG6 Frame Buffer Generates 
Errors with Some PROMs 
(1030399) 


On SPARCserver 390s with PROMs earlier than 3.0.2 and on SPARCsystem 4X0s 
with PROMs earlier than 3.0, the CG6 frame buffer may generate screen errors or 
garbage screen when dmesg runs on the console. Problems include keyboard 
buffering (characters not being printed on the screen or recognized until a car¬ 
riage return is entered), and mouse event states not being reset (for example, if an 
event state is not reset, once you scroll up on a scrollbar, you cannot scroll down, 
or do anything else with the mouse). 


10.9. Sundiag 


Sundiag Reports Loopback 
Errors While Testing mcp 
(1068117,1068776) 


If you install the SunLink HSI/S 1.0 software after installing SunOS 4.1.2 on 
your system, the sundiag provided with the HSI/S distribution will overwrite 
the SunOS 4.1.2 sundiag, which includes bug fixes for bugs 1068117 and 
1068776. 

To preserve the bug fixes, save the SunOS 4.1.2 

/usr/diag/sundiag/sunlink test file prior to instalhng the HSI/S 
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Sundiag 2.3 Fails Startup 
Probe Because of False 
devinf o (1071674) 


software (for example, move the sunlink file to sunlink. orig), and 
restore it after installing the HSI/S software (move sunlink. orig back to 
sunlink). 

Sundiag uses the /usr/etc/devinf o program in its probing routine when it 
first starts up. devinf o finds eight drives for any IPI controller, regardless of 
whether there are eight drives on the controller. The result is that sundiag 
displays probing failures such as the following if fewer than eight drives are on 
an IPI controller: 

- 

bench_3401 ./probe ERROR: /dev/ripOc open error: No such device 

V_/ 


There is No f ddi Test in 
Sundiag 2.3 Alpha 5 (1070359, 
1070602) 


Sundiag 2.3 does not include an option to test Sun-4m VME fddi devices. A 
.usertest file containing the following line can be used in 
/usr/diag/sundiag to have nettest verify the device: 


f 

A 

nettest, Fddi, net fddiO D=10 


V 

_/ 


10.10. Sun386i 


386i diskless client is not When installing 386i diskless client on SunOS 4.1.2, the 386i SunOS 4.0.1 server 

added successfully (1071266) kit script, sun386client tries to modify /var/yp/Makef ile, checking 

only for the existence of the auto .master map. Only two of the three neces¬ 
sary NIS maps are added; auto. vol, which is needed by 386i clients, is not 
added. 


Sun386i Server Kit Causes All On a heterogeneous server, the Sun386i Server Kit creates automount maps in 

Clients to Automount /home /etc/f stab for all clients, including non-386i clients. This means all clients 

(1043173) run automount to mount home/servername. The problem is that all non-386i 

clients already had /home entries in f stab. Thus they have separate auto¬ 
mount /home entries and non-automounted /home entries. 


The workaround is for the server and all non-386i clients to edit 
/etc/rc. local and change the line 


r 

A 

automount echo -n ' automount' 


1 



to 

automount -m && echo -n ' automount' 

V_/ 
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10.11. Documentation 


Corrections to System and 
Network Administration 

Misleading Instructions on On page 247, Step 6 of the instructions for using a file to create extra swap space 

Using a UNIX file for Swap calls for entering the following command: 

Space (1039946) 


The command is correct for setting up a file to be used by a client system over 
the network. The command fails if it is used to create a local file on the same 
machine that will be using it. Characteristic error messages are: 



To set up a local file for a standalone system or server to use for added swap, you 
must leave out the -n option: 



Error Message and In Table 21-6 (incorrectly labeled “Table 21-1”), page 687, an error message and 

Explanation Incorrect its description are incorrectly given. The error message is: 



The description should read: 
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Unresolved Cross References 


• On pages 257 and 261, the reference “See the section on 
@TitleOf(repair.sector)’' should read: 

See the section on Repairing a Defective Sector 

• On page 269, the reference “See the section on @TitleOf(defect.list)" should 
read: 

See the section on Creating a Defect List 

• On page 279, the reference “See the section on @TitleOf(using.format)" 
should read: 

See the section on Using ±ormait for Basic Maintenance 


Corrections to the SunOS 
Reference Manual 

Remove skyversion(8) man The printed version of the sky vers ion(8) man page is specific to Sun-2 sys- 
Page terns, which are no longer supported. It should be ignored. The online man page 

has been removed. 

Correction to Network 
Programming Guide 

Incorrect Warning at The warning at the beginning of Chapter 10 of the Network Programming Guide 

Beginning of Chapter 10 is in error. Socket-based IPC has not been superseded by the UNIX system 

Transport-Level Interface; any statements implying that it has been are incorrect. 
The first paragraph in Chapter 10 should be replaced with the following text: 

This chapter provides detailed information, with various examples, on the 
UNIX system Transport-Level Interface. This interface is intended to pro¬ 
vide the user with a more structured transport-level interface than that which 
is provided by the socket interface, and as such deliver tranport- 
independence in a transparent manner. 

TLI does not supersede sockets but is intended to offer the developer another 
mechanism by which to assure that applications under development can and 
will exist autonomously, regardless of the network or transport protocols. 

10.12. CD-ROM 


Actions Causing SunCD to 
Hang System (1033100, 
1032990) 


To prevent your system from hanging when using a CD-ROM, do not: 

• Attempt to access a defective or “bad” CD-ROM (one that contains recover¬ 
able recording errors); 

• Access a non-HSFS disc on the cd-rom drive. 
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• Eject the CD-ROM while the CD-ROM file system is still mounted. 

• Turn the CD drive off while the CD-ROM file system is still mounted. 


Sunlnstall Can Only Find Suninstall has an internal list of devices it can use for reading installation media. 

CD-ROM at srO (1044687) The only CD-ROM device included is srO. 


CD-ROM e ject(l) May Not 
Work on a Read Failure 
(1033102) 


If for some reason the CD-ROM driver can’t read a CD (as in the case of a defec¬ 
tive disc) the eject command may also fail, returning the following error mes¬ 
sage: 

# eject cd 

eject: Open fail on cd -> /dev/rsrO:.I/O error 


You can eject the disc manually. 


CD-ROM Error Messages on Messages similar to the one below may appear on the console at various times, 

Console (1032918) most often when you mount the CD-ROM or run demos from it. They can be 

disregarded. 


srOa: read recoverable, block 198000 

sense key (0x1): soft error, error code(0x18): soft data error 
V_/ 


10.13. Library 

textdomain(3) Requires The SunOS Reference Manual documents the textdomain(3) library function 

Two Arguments (1045495) as only requiring a single argument. However, the code for text domain () 

expects a second argument. Without the argument, a program calling 
text domain () dies with a segmentation violation. The second argument has 
no operational effect. It was called for in the original design of the function, but 
when the design changed and it was no longer necessary, the code that tested for 
its presence was never dropped. 


The workaround for the problem is to use a dummy second argument in pro¬ 
grams that call text domain (): 



A 

textdomain("domain name",""); 


V 

J 
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10.14. Miscellaneous 


mb status and mt asf The use of the mtgetstatus ioctl data structure changed in SunOS 4.1. Asa 

Commands Under SunOS result, SunOS 4.0.3 (and earlier) binaries for mt status and mt asf cannot 

4.0.3 Not Compatible with be used with SunOS 4.1 .X. 

SunOS 4.1.x 

You Cannot Install SunShield See the workaround in Chapter 7 of the Release Manual. 

on SunOS 4.1.2 using 
cdmanager (1069654) 


10.15. OpenWindows 
Version 2 

You Must Remove or Edit If you already have a . xinitrc file in your home directory, make sure you 

. xinitrc File in /home either remove it or edit it according to the instructions in Chapter 2 of the 

OpenWindows Installation and Start-Up Guide before you start OpenWindows 
for the first time. 


You Must Move 
app-defaults Directory 


The app-defaults directory in /usr/openwin/lib/app-defaults 
should be moved to /usr/openwin/lib/Xll/app-defaults before ins¬ 
talling OpenWindows on your system. To make the change, become superuser 
and enter the following commands: 




% su 


Password: [ enter root password ] 


# cd /usr/openwin/lib 


# mkdir Xll 


# mv app-defaults Xll 


V ■■ ■ ■ . 

. ) 


Running NeWS Applications 
on a Non-Networked 
Standalone System 


In order to run NeWS applications on a standalone workstation that is not con¬ 
nected to a network, you must start OpenWindows with the -noauth option so 
that security is not enabled. This is necessary to bring up the tutorial as part of 
the default desktop on a standalone workstation. If the -noauth option is not 
used, the following error message will be displayed: 


r 

N 

XNeWS Network security violation 

Rejected connection from; hostname 


\ _ 
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Open Windows Invoked from 
Command Line does Not 
Reset Foreground Color 
Correctly (1041554) 


If you invoke OpenWindows from a command line, it will not reset the fore¬ 
ground color when it exits. For example, if you are in color SunView and invoke 
OpenWindows from the shell (%) prompt, when you exit OpenWindows, you will 
not be returned to the initial SunView color foreground. To reset the foreground 
color, enter the command: 


r .... . 

A 

%clear__colonnap 



) 


Exiting OpenWindows May 
Cause Display of Error 
Messages (1044695) 


In some cases, when the OpenWindows window manager (olwm(l)) exits a pro¬ 
gram, an error message is generated. This may happen when fasthalt(8)or 
f astboot(8) are used. Examples of the error messages generated are: 


XIO: fatal 10 error 32 (Broken pipe) on X server "0.0" 

V_ J 


and 


WIN ioctl number c0286722: Inappropriate ioctl for device 
V_ ) 


You can safely ignore the messages if they are displayed when you intentionally 
exit OpenWindows. 

The messages are generated when olwm exits an XI1 program that is not fully 
compliant with the ICCCM mechanisms for interacting with a window manager. 


Control-C When 
OpenWindows Version 2 is 
Starting Freezes Window 
System (1039856) 


If you press your interrupt character (usually (Control-C 1 ) to halt OpenWindows 
when it is starting up, the OpenWindows windows still come up on screen and 
the mouse cursor can be moved across them, but all mouse and keyboard buttons 
are frozen, so that no window activity is possible. This is because the Window 
Manager was interrupted, but other components of the window server were not. 
Since the window system cannot respond to your keyboard in this situation, you 
need to rlogin to your own system from another machine on the network and 
stop the window server. To stop the window server: 

1. Get the server’s process ID: 





:# 

ps uax 1 grep xnews 


L_.. 


> 

2. 

Halt the process: 


#: 

kill [process~ID] 

1 





If you cannot rlogin to your system, call your local Sun Answer Center for 
assistance. This problem is corrected in OpenWindows Version 3. 
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Error Message for Incorrectly In the unlikely event that your keyboard DIP switches are set incorrectly, you 
Set Keyboard DIP Switches will see the following message when you start up OpenWindows: 


- 

ClassKeyboard couldn't initialize the keyboard. 

Process: OxlebcSc (Unnamed process) Error: undefined 
Stack: (NeWS/interest.ps) marker /BasicKeyDicts marker 

Executing: asciiOOO 

At: {*ascii000 asciiOSO asciiOOL asciiOSO asciiCOO asciiCOO asciiCOO 
asciiCOO} 

In: Reading file ('NeWS/interest.ps',R) 

Sic transit gloria PostScript 
giving up. 

xinit: Connection refused (errno 61): unable to connect to server 
V_ 


If you are using a Type-4 keyboard and SunOS 4.1.X, all DIP switches on a U.S. 
keyboard must be set to "0" or "off. See Chapter 3 of the OpenWindows Instal¬ 
lation and Start-Up Guide for the settings for international keyboards. 


Problem with FI (Help) Key On Type-4 keyboards, the FI (Help) key does not work properly if either Caps 
on Type-4 Keyboards Lock or Num Lock is on. 


Error Message for Incorrect 
Permissions on /tmp 
Directory 


If OpenWindows displays the following error message: 


XNeWS: there is already a NeWS server running on :0 
giving up. 

/usr/openwin/bin/xinit: Permission denied (errno 13): unable to 
connect to X server 

V_/ 


Check the permissions on the /tmp directory. They should be: drwxrwsrwt. 


Do Not Resize Text 
Sub-Window Smaller Than 
the Top of the Bottommost 
Split 


Resizing split text subwindow smaller than the top of the bottommost split 
causes the program that owns the text subwindow to crash. Any changes in any 
of the program’s windows that have not been saved previously are lost. This bug 
affects File Manager, Mail Tool, and Text Editor, as well as all other application 
programs that use text sub-windows. If you are using the split feature of text 
sub-windows, you should not resize the text sub-window smaller than the top of 
the bottommost split. 
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Mail Tool: Running out of Mail Tool does not handle running out of disk space in /tmp gracefully. If you 

Disk Space in /tmp have too large a mail spool file, or too little space in /tmp, Mail Tool may give 

an error message, terminate, and possibly leave a lock file, which you will need 
to remove, in/usr /spool/mail. The name of the file is username, lock. 
To remove the lock file, enter: 


r~~' ———— ' ;■ ___ __ 

% rm /uar/spool./maiLl/ username. lock 

V _^^^_ 


If Mail Tool runs out of space in /tmp while running, it is possible that deleting 
messages from the In Tray may result in the deleted messages being duplicated 
and sequenced out of order. 

It is recommended that you hold down the size of your spool file by limiting the 
number of messages in your In Tray. In addition, you can conserve disk space by 
removing unnecessary files from the file system containing /tmp. 


Do Not Disable Scrolling in Disabling scrolling in one of the windows of a split-screen Command Tool may 
One of the Windows of a cause it to crash. 

Split-Screen Command Tool 


File Manager Can Crash If The File Manager can crash if too many editing sessions are started in a short 

Too Many Editing Sessions period of time. When this happens, all unsaved changes are lost. To prevent 

Are Started such crashes. Sun strongly recommends that you do the following: 

1. Select Tool Properties from the Properties menu button on the File 
Manager control panel. 

2. Click on the Other option next to Default Document Editor. 

3. Fill in the blank with: 
textedit "$FILE" 

4. Press the Apply button at the bottom of the window. 


File Manager’s Wastebasket 
Icon May Be Invisible Or 
Appears As a Short Text 
String with No Picture 


If the File Manager’s Wastebasket icon appears as a short text string with no pic¬ 
ture, double-click on the string. This will open up the Wastebasket window. 
When you close the Wastebasket window, the icon will assume its normal 
appearance. 

If the Wastebasket icon is initially invisible, exit and restart the File Manager. In 
most cases, this will solve the problem. If the icon is still not visible, either click¬ 
ing around the edge of the screen where your other icons are located or select 
Screen Refresh from the Utilities menu. Screen Refresh produces a 
short text string, as described above. Follow the previous instructions to get the 
normal Wastebasket icon. 
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Application Programs Can On monochrome monitors, application programs can move new or updated win- 

Move Windows in Front of the dows in front of the Lock Screen. As a result, the contents of a window may be 
Lock Screen on Monochrome displayed even when the screen is locked. This can happen, for example, if you 

Monitors lock the screen as soon as you start saving a large Mail Tool infile. When the 

Mail Tool save is completed, the message view window will still be displayed, in 
spite of the screen lock. Color monitors do not exhibit this problem. 


Adjusting for Open Windows OpenWindows Version 2 supports monitors with overscan capabilities. For 
Monitors with Overscan monitors running in overscan mode, the server can be started up with an adjusted 

Capabilities viewing size in order to compensate. 

In future systems, the need to run in overscan mode may automatically be deter¬ 
mined at startup time. However, there will be occasions when XI 1/NeWS is run 
on a second non-overscan monitor, or on monitors that are not properly aligned, 
or are of an unusual size. In these cases, overscan mode may have to be shut off 
or the dimensions of the visible area changed. To allow for the eventualities, the 
following command-line arguments will be supported by XI 1/NeWS once the 
overscan code is installed. 

• -dev [fbname] 

This option will tell the server what device to display on. This replaces the 
usage of the FRAMEBUFFER environment variable in OpenWindows 1.0. 

• -overscan [percent] 

This option instructs the server to shrink the visible area by the indicated 
percentage and perform the necessary offsetting. If a percentage of -1 is 
given, the shrinkage will be set to the default. If a percentage of 0 is given, 
overscan mode will be disabled and the server will use the full size of the 
screen. This will allow users to override any defaults if a particular monitor 
doesn’t behave to their liking. 

In addition, if the -overscan option passes a non-zero value, it will enable 
the special overscan functionality (the flooding of the unused border regions 
with the root X color/pattem and the constraining of the cursor to the root 
canvas). 

• -rect [LTWH] 

This option instructs the server to use a viewing area described by the rec¬ 
tangle passed in. Note that this mode will not perform the special 
cursor/border functions which are part of overscan mode unless overscan 
mode is also enabled. This option simply sets an explicit viewing area. 

Examples: 
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# Run xnews in default overscan mode, overriding any defaults. 
lxnewa:;:--dveir;S:Can i-r’i;:X:::. 

# Run xnews in overscan mode but with a set shrinkage of 10%, 

# overriding any defaults, 
xnews -overscan 10 

# Run xnews with overscan mode off, overriding any defaults, 
xnews -overscan 0 

# Run xnews with an explicit view area and overscan mode shut off, 

# overriding any defaults. 

xnews -overscan 0 -rect 200 200 600 600 


GX Hardware Cursor May Be 
Left on Screen after Exiting 
Open Windows 


There are some cases in which the GX hardware cursor is left on the screen after 
exiting OpenWindows. The workaround is to compile and run the following pro¬ 
gram: 


<#sun 
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/* 

* gxcursor — disable GX cursor 

* to compile: cc -0 -o gxcursor gxcursor.c -Ipixrect 
*/ 

#include <stdio.h> 

♦include <sys/types.h> 

♦include <sys/ioctl.h> 

♦include <sun/fbio.h> 

♦include <pixrect/pixrect.h> 

♦include <pixrect/memvar.h> 

struct cg6pr { 


struct mprp data mprp; 

/* 

memory pixrect simulator 

int fd; 

/* 

device file descriptor * 

struct pr size cg6 size; 

/* 

screen size */ 

caddr_t cg6_fbc; 

/* 

FBC base */ 

caddr t cg6_tec; 

/* 

TEC base */ 


}; 

♦define THCOFFSET (5 * 4096) 

♦define THC_CURSOR OxSFC 

main(argc, argv) 
int argc; 
char *argv[]; 

{ 

char *dev = argc > 1 ? argv[l] : "/dev/fb"; 
int fd; 

struct fbgattr fbattr; 

Pixrect *pr; 

if ((fd = open(dev, 2, 0)) < 0) 
perror(dev); 

if (ioctKfd, FBIOGATTR, &fbattr) <0 11 

fbattr.fbtype.fb_type != FBTYPE_SUNFAST_COLOR) 

fprintf(stderr, "device %s is not a GX frame bufferO, dev); 

(void) close(fd); 

if ((pr = pr_open(dev)) == 0) 

fprintf(stderr, "pixrect open failed for %s0, dev); 

* (int *) (((struct cg6pr *) pr->pr_data)->cg6_fbc + 

THCOFFSET + THC_CURSOR) = OxffeOffeO; 

exit (0); 

} 

^ _ . 


GX with Open Windows on When you run on a GX and have OpenWindows displayed on multiple screens, 

Multiple Screens: Some operations that warp the cursor to a new position (such as scrollbars and 

Operations May Leave Cursor pop-ups) may leave the cursor invisible until you move the mouse. This 
Invisible behavior does not start until after the mouse cursor visits the non-GX screen. 

Once the disappearing cursor starts, it is non-deterministic (due to a race 
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condition), so it shows up about 50% of the time. Three workarounds follow: 

• Set the Scrollbar Pointer Jumping and Pop-up Pointer 
Jumping properties in the “Mouse Settings” Workspace property sheet to 
off, then restart OpenWindows. This fixes the most common XView 
symptoms. 

• Adjust the OpenWindows . Popup JumpCursor and 
Scrollbar. JumpCursor properties in the "/.Xdefaults file to be 
False. For example: 

- 

OpenWindows.PopupJumpCursor: False 

Scrollbar.JumpCursor: False 

. _ ) 


This fixes the most common XView symptoms. 


• Permanently disable the new hardware cursor tracking feature in the kernel 
by adjusting a kernel variable and rebooting: 


r- ■ . 

■N 

% SU 


Password: [enter root password ] 


# adb -w /vxnunix /dev/kmem 


not core file = /dev/kmem 


win do hw cursor?W 0 


$quit 


# /etc/fastboot 



. • J 


Under this workaround, cursor tracking may lag behind mouse motion in 
some circumstances. 


BadAlloc Xerror Results 
from Large Number of Panel 
Items 


In XView, the number of panel items is unlimited. However, after a certain point, 
the server will run out of virtual memory with the message: 


r 


BadAlloc Xerror 


V 

y 


CANVAS_PAiNTWiNDOW_ATTRS lu Due to a bug in the XView canvas package, trying to set some canvas paint win- 

the Create Call of a Canvas dow attributes using canvas_paintwindow_attrs in the create call of a canvas 

May Not Work Correctly will not work correctly. The attributes that fail are win_bit_gravity and any¬ 

thing that adjusts the window’s event mask (e.g., win_consume_event (S) and 
wiN_iGNORE_EVENT (S) ). The work around is to set the 
CANVAS_PAiNTwiNDOw_ATTRS after the canvas has been created. 

For example, given: 
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canvas = (Canvas)xv_create(frame, canvas, 

. . ., 

CANVAS_PAINTWINDOW_ATTRS, 

wiN_BiT_GRAViTy, SouthWestGravity, 
WIN_CONSUME_EVENT, L0C_DRAG, 

0 , 



you would produce the following: 


canvas = (Canvas)xv_create(frame, canvas, 

• • • f 

0 ); 

xv_set(canvas, 

CANVAS_PAINTWINDOW_ATTRS, 

wiN_BiT_GRAViTY, SouthWestGravity, 
WIN_CONSUME_EVENT, L0C_DRAG, 

0 , 

0 ); 


SunView Compatibility under 
Open Windows Does Not 
Work with GS Systems 
(1048981) 


If you have a SPARCstation with GS graphics, the SunView compatibility 
feature of OpenWindows does not work correctly. When running a SunView 
application under OpenWindows, the screen goes blank and the XNeWs server 
eventually dumps core and terminates. 


Using DNI 


• If you run the XI 1/NeWS server over DNI, you will crash the server if you 
view an access list using xhost after adding a host to the list with 
newshost. 

• You must unset the environment variable DNI_X_ENABLE before starting 
the server if DNI is not in a mode that accepts connections. 

• If you turn off the network node state while the server is running, you will 
crash the server. 

• You can cut text from an OpenWindows application into a DEC application, 
but not from a DEC application to OpenWindows. 
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10.16. OpenWindows 

Version 3 Product 
Notes 


Installation Issues 

Do Not Install SunOS 4.1.1 
Patches 


Do Not Remove 
OpenWindows Version 2 
During Installation of 
Versions 


Check Space Available Before 
Installing OpenWindows 
Version 3 


Installation Cluster Sizes 




The following sections, from OpenWindows Version 3 Product Notes (Part 
Number 800-6387-10), contain important information about this release of the 
OpenWindows software. See the following documents for additional release and 
installation information: 

• OpenWindows Version 3 Release Manual 

• OpenWindows Version 3 Installation and Start-Up Guide 


There are SunOS 4.1.1 patches available in 

$OPENWINHOME/lib/OSpatches. Do not install these patches on your 
SunOS 4.1.2 system. 

During installation of OpenWindows Version 3 you are given the option of 
removing OpenWindows Version 2: 

Do you want to remove the current contents of 
the /usr/openwin directory? [y|n] 

'v_ ) 


Do not respond “y” if you are doing the installation while miming OpenWin¬ 
dows; the system will be in an unstable state if you do. If you exit OpenWin¬ 
dows before starting the installation and you decide to remove OpenWindows 
Version 2, be sure you have room for OpenWindows Version 3, as described 
below. 

OpenWindows Version 3 uses more space than OpenWindows Version 2 — over 
85000 kilobytes for all packages vs. about 40000 kilobytes for all packages with 
OpenWindows Version 2. Be sure you have sufficient space available before 
beginning your SunOS 4.1.2 installation. See Table 10-2 below for information 
about how much space is needed for various OpenWindows configurations. 

The subset sizes for installation packages provided in the OpenWindows Installa¬ 
tion and Start-Up Guide are incorrect. Table 10-1 below lists the sizes of the 
packages. Note that some of the packages are subsets of the others (see the 
OpenWindows Installation and Start-Up Guide for the contents of each package). 
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Table 10-1 


Table 10-2 


Installation Packages 


Package and Content 


Disk Space Required 

Required Package 


27700 Kbytes 

Online Man Pages 


1300 Kbytes 

Library Interface Man Pages 


2100 Kbytes 

Online Handbooks 


2(X)0 Kbytes 

Optional MIT Release 


2300 Kbytes 

Demo Programs 


2800 Kbytes 

Demo Images 


5100 Kbytes 

Include Files 


3000 Kbytes 

Lint Libraries 


600 Kbytes 

Static Libraries 


10700 Kbytes 

Sample Source 


7900 Kbytes 

Optional Fonts 


10100 Kbytes 

Table 10-2 below lists the space used by the installation clusters. Note that the 
amount of space requested by the script (“Script Requests”) differs from what is 

actually used (“Space Used After Install”). 


Installation Clusters 



Cluster and Content 

Script Requests 

Space Used After Instal 

Minimal Configuration 

31000 Kbytes 

31588 Kbytes 

End User 

41100 Kbytes 

41233 Kbytes 

Advanced User 

43400 Kbytes 

43412 Kbytes 

Advanced User with Demos 

51300 Kbytes 

51168 Kbytes 

Programmer* 

67700 Kbytes 

66556 Kbytes 

Full OpenWindows 

85700 Kbytes 

74312 Kbytes 


* Does not include Demos. 


If your disk has the space necessary for the cluster or package (see the column on 

the right in Table 10-2), but not the amount that the installation script requests 

(middle column), the script will not allow you to install. To solve this problem: 

1. Use the df command to find a disk partition — / var / tmp, for example — 
that has extra space. 

2. Move files from the disk partition that you are installing onto to the disk par¬ 
tition with extra space. 

3. Move enough files so the disk partition that you are installing onto has the 
necessary space (listed in the middle column of Table 10-2 above). 

4. Run the installation script. 

5. Move the files back to the disk partition that you installed on. 
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Missing F3 Fonts with the If you have installed the OpenWindows software using the minimal configuration 

Minimal Configuration cluster, note that this configuration does not include the full set of F3 fonts. Many 

Cluster OpenWindows applications, including NeWSprint and FrameMaker for 

OpenWindows, cannot run without these fonts in place and will fail under the 
minimal configuration. 

If you intend to run NeWSprint or other unbundled or third-party apphcations in 
the OpenWindows environment that require these fonts, you must install a cluster 
that includes the full F3 font set (i.e., the End User Cluster or one of the ones 
listed below it in Table 10-2). See the OpenWindows Version 3 Installation and 
Start-Up Guide for details. 


Installing the OpenWindows 
Software with cdmanager 


If you perform the installation of OpenWindows Version 3 in an OpenWindows 
Version 2 session, you can then exit the OpenWindows Version 2 session, set 
OPENWINHOME to point to the newly installed OpenWindows Version 3 
software, run $OPENWINHOME/bin/install_openwin, and startup the 
OpenWindows Version 3 environment. 

As stated in the CDManager and CDM User Instructions, follow these steps to 
mount your CD-ROM containing the OpenWindows Version 3 software when you 
use cdm or cdmanager: 

r —^-—---- ■ ■ ,, ^ ——— N 

example% su 
example# cd / 

example# mkdir /cdrom {only if directory does not exist) 

example# mount -r /dev/srO /cdrom 
example# cd /cdrom 

example# cdm (cdmanager if you are running openwin) 

\ ___ 


It is possible to install the OpenWindows Version 3 release with cdmanager or 
cdm under an Openwindows Version 2 session. As noted above, though, do not 
perform the installation in an OpenWindows Version 2 window if you are going 
to remove OpenWindows Version 2 during the installation. 


Running cdmanager Remotely When you attempt to run the cdmanager remotely, the following error message 


may appear: 


f 

Id.so: libxview.so.3 not found 


V 

) 


To avoid this problem, make sure that you have set your environment correctly. 
See “Setting the Environment Correctly” below for more information. Also note 
that any time you mn a program remotely, you must xhost the machine with 
the display that you are displaying the program on. 
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OpenWindows Version 3 
Installation and Start-Up 
Guide Corrections 


Start-up 

Setting the Environment 
Correctly 


Note the following corrections to the OpenWindows Version 3 Installation and 
Start-Up Guide: 

• page 1, Section 1.1: 

Replace the first bullet item with the following: 

“The system architecture must be Sun-4, Sun-4c, or Sun-4m.” 

• page 23: 

Add the following to the last paragraph: 

“The -nosunview option is not supported on the GXplus, TC, GS, or GT 
graphics devices.” 

• Chapter 6: 

Add the following installation troubleshooting note: 

“If you are running OpenWindows with a graphics accelerator, and perfor¬ 
mance seems poor, the OpenWindows software may have been improperly 
installed. Verify that the OpenWindows software was installed by root, 
that proper suid modes were preserved, and that 
$OPENWINHOME/bin/install_openwin was run by root. If you 
have access to XGL, run the XGL install_check program to verify that 
DGA is operational. Contact your system administrator for further assis¬ 
tance.” 

• Appendix A, section A.3, pages 40-41: 

Replace this section with the following: “DGA is supported on all SBus dev¬ 
ice configurations in table A-1 on page 39. DGA is not supported on any 
VME or P4 device configurations in table A-1 on page 39.” 


The openwin script sets your executable path to have the location of the 
OpenWindows version of the DeskSet tools before the location of the SunView 
tools of the same name. If you are using the C shell, make sure you run the 
OpenWindows tools first when you start the server. Make sure that your 
. cshrc file does not reset your path to have /bin and /usr/bin before 
$OPENWINHOME/bin and $OPENWINHOME/bin/xview. In addition, the 
openwin script sets your library path. If you do not have your library path set 
correctly, the following error message may appear when you invoke a deskset 
tool from the command line: 

( ^ 

Id.so: libxview.so.3 not found 

V_ ) 


You may want to add the following lines to your . cshrc file so that your 
environment is set up correctly for remote logins: 


A 
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-- ^ 

setenv OPENWINHOME {installed location of OpenWindows) 

setenv LD_LIBRARY_PATH $OPENWINHOME/lib:/usr/lib 

set path=($OPENWINHOME/bin $path) 

V___ y 


Frame Buffer Issues Some frame buffers require special use under the OpenWindows Version 3 

environment: 

• GT 

For OpenWindows applications using the TnieColor visual (for example, 
that use the same color value that is used on a GS framebuffer), the color 
will look brighter (or more washed out) on a GT. This is because the GT 
hardware provides gamma correction to account for the sensitivity of our 
eyes to low intensities. This give GT images that use shading and anti¬ 
aliasing a higher quality. The gamma correction feature is described in detail 
in the SunPHIGS and XGL Programmer's Guides. It can be turned off as fol¬ 
lows: 

^ __ _ __ __ ^ ^ 
example# gteonfig -G-1 


Note that graphics (SunPHIGS and XG-based) programs will have lower 
quality images. 

♦ TC (CG8) 

If CG8 is the default frame buffer, you must specify the device when starting 
up the OpenWindows software with the openwin command: 

example#' openwin -dev /dev/egeightO 

^ : ' ' ' •' ____ ■■ _ .■ ' ' ■■■ _ ) 


Screen Blank (Screensaver) The OpenWindows Version 3 release has an automatic screensaver feature that 

makes the screen go blank after a period of no use. The OpenWindows Version 3 
Release Manual incorrectly states that this feature is enabled by default. To 
enable this feature, you must type the following at the command line: 


. ■ , 

. A 

example% xset s on 



_ ■ ■ J 


When you exit the OpenWindows environment, the screensaver feature is turned 
off. For more information, see the xset(1) man page. 

realxf ishdb Demo The realxf ishdb demo in $ OPENWINHOME /demo is broken in the 

OpenWindows Version 3 release. Although the root window will be painted, 
no fishes will appear. You can obtain a working version from the February 1991 
Catalyst CD. 
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Compatibility with the 
Open Windows Version 2 
Release 

NeWSPrint The NeWSprint 1.0 software does not work with the OpenWindows Version 3 

release. Support for the OpenWindows Version 3 release will be in the next 
release of the NeWSprint software. To continue using the NeWSprint software, 
you must re-install it with small_openwin, a stripped-down version of the 
OpenWindows Version 2 software. For more information, see Chapter 12 of the 
OpenWindows Version 3 Release Manual. 

XView Because error checking has improved with the OpenWindows Version 3 release, 

the XView libraries will catch some common programming errors that were not 
caught with the OpenWindows Version 2 XView libraries. For example, with the 
OpenWindows Version 2 release, not terminating attribute lists with a NULL 
was acceptable. In the OpenWindows Version 3 release, this error can cause an 
application to crash with a SIGSEV error. 


The following is acceptable OpenWindows Version 2 code, but is not acceptable 
OpenWindows Version 3 code: 


r 



XV set(sliderltem. 

PANEL MAX VALUE, 100); 


XV set(sliderltem. 

PANEL_VALUE, 100) ; 


V 


J 


This is correct code, which will run under OpenWindows Version 3: 

xv_set(sliderltem, PANEL_MAX_VALUE, 100, NULL); 
xv_set(sliderltem, PANEL_VALUE, 100, NULL); 

V._/ 


Devguide 1.1 Using Devguide 1.1, the following pinnable menu code is not correct, even 

though it worked under the OpenWindows Version 2 release: 

caddr_t *ip; 

MENU_GEN_PIN_WINDOW, (Xv_opaque)ip[0] , ”", 

V_/ 


The code should actually be: 


r 

A 

MENU_GEN_PIN_WINDOW, owner, 


1 

) 


In this example, the menu’s owner was not set correctly to the tool base frame. 
Under the OpenWindows Version 2 release, even though the code is incorrect, it 
will work: the pinned menu unmaps when the tool is iconified. In the OpenWin¬ 
dows Version 3 release, XView is more rigorous about checking window owner¬ 
ship: when the menu is pinned and the tool is iconified, the menu stays up. 
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SunView Compatibility 


Sun Applications Not 
Supported Under the 
Open Windows Version 3 
Release 


If you see the following message on your screen after you type openwin: 

Id.so: libsunwindow.so.0: not found 
giving up. 

/usr/openwin/bin/xinit: No such file or directory (errno 2): 
unable to connect to X server 

V_ ) 

do one of the following: 

• install the SunOS Sunview-Users Subset from the SunOS media (if you want 
to run SunView applications) 

• use the -nosunview option with the openwin command (if you do not 
want to run SunView applications) 

The following Sun applications are not supported under the OpenWindows Ver¬ 
sion 3 release: 

• SparcWorks Ada 1.1 

• NSE 1.3 


Xll/NeWS Server Issues 

4-bit Visuals NeWS and TNT are not supported on a 4-bit visual. 

XDrawImageString () and The XI 1/NeWS server may crash on the Xlib function calls, XDrawImage- 
XDrawImageStringie () StringO and XDrawImageStringl 6(), on an GS framebuffer, when the 

default depth is 24 (e.g., openwin -dev /dev/cgl2 defdepth 24). 
This will only occur when the width or the height of the window being drawn 
into is an out-of-range integer value (e.g., a negative number). 

The workaround is to verify the window width and height. Instead of that 
verification, you can use the Xlib function call XFillRectangleO with 
XDrawStringO, which will print an error message if the window width or 
height is an out of range value. 


International (8-bit) User if you choose the Format option from the Extras Menu in a text sw or termsw. 

Issues any 8-bit characters (characters with diacritical marks, such as accents) in the 

subwindow will be lost if LANG is not set to a European language, or LC CTYPE 
is set to C, or either one is not set at all. To work around this problem, se? 
LC_CTYPE to iso_885 9_l in your .profile or . cshrc file, as described 
in Chapter 9. 
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Frame Menus and Dynamic The frame menus managed by olwm do not always adhere to dynamic locale 

Locale Changes changes. For example, you may initially change the Display Language locale 

through the Workspace Properties sheet successfully. However, subsequent 
locale changes will not affect the frame menu. To work around the problem, 
restart olwm by exiting the window system and restarting openwin. 


Incorrect Sorting in File 
Manager and Mailtool 
(1053980) 


Sorting of file and directory names in File Manager and sorting of mail in Mail- 
tool may be incorrect for locales other than the C locale. 


DeskSet Issues 


Running Deskset Application 
Remotely 


If you are starting a Deskset application from a remote system that does not have 
OpenWindows stored in /usr/openwin, you will get the error: 


r 

Id.so: libxview.so.3 not found 

> 

V 

_ ) 


To work around this problem, set the LD_LIBRARY_PATH environment vari¬ 
able on your remote system to $OPENWINHOME/lib. 


Cutting and Pasting When you Cut and Paste, or directly manipulate a line with non-printable charac- 

Unprintable Characters ters, it may get truncated if you paste or drag it to a text field. Pasting or dragging 

to a textsw works as expected. 


Tape-Reading Limitations There is a limitation when reading a tape using the Read Entire List or the Read 

Selected option from tapetool. The total buffer size of the tar command cannot 
exceed 1024 bytes. Therefore, in the case of the Read Selected Option, the total 
length of all selected pathnames from the scrolling list cannot exceed 1024 bytes. 
In the case of the Read Entire List option, the total length of all filenames in the 
scrolling list cannot exceed 1024 bytes. If the total length of all files to be read 
does exceed 1024 bytes, tapetool will only read those files up to the 1024 
byte maximum and will terminate the Read option with an alert message display¬ 
ing the last file that it attempted to read. 


Problem Returning to If you use the OpenWindows Version 2 software after you have been running the 

OpenWindows Version 2 from OpenWindows Version 3 software, the Version 3 Calendar Manager may cause 

OpenWindows Version 3 problems for the Version 2 Calendar Manager. To avoid this, back up your 

/usr/spool/calendar/callog. <user> file before starting the Version 
3 Calendar Manager. If you later go back to Version 2, you should restore your 
old file. 


Problem with Mailtool 
Attachments from 
OpenWindows Version 3 
System 


Be careful when you mail attachments from Mailtool to people who are not using 
the OpenWindows Version 3 Environment. Their mailer will not be able to 
unbundle the attachments in the same way as Mailtool. The attachments must in 
this case be unbundled by hand by using an editor and sometimes 
uudecocie(l); uudecode can easily unbundle one attachment, but the file 
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must be broken up into pieces if more than one attachment is mailed. 

Mailtool Swap Space Problem Mailtool may run out of swap space if you drag-and-drop a file that is too large 

into the Mailtool Attachment window. The workaround is to increase your swap 
space. 

Calendar Manager Problems If the Calendar Manager is not working correctly, make sure you have run the 

install_openwin script (as root). 


Toolkit/XView Issues 

Problem if No SunView If your system is installed without SunView files or you use the -nosunview 

option to start the OpenWindows environment, you may encounter the following 
warning when you start up a Version 2 XView-based application: 

System warning; No such file or directory, extras menu file 
/usr/lib/.text_extras_menu (Textsw package) 

I_ 

You will not be able to use the extras menu in the text subwindow. To work 
around this problem, add the following to your . Xdefaults file: 

text.extrasMenuFilename: 

OPENWINHOME/lih/locale/C/xview/. text_extras_menu 
V_/ 

where OPENWINHOME is the value of $OPENWINHOME. 

Selection Transactions Not If selection transactions do not complete successfully (e.g., Mailtool attachments 
Complete Successfully do not display data, or drag-and-drop operations fail), it may be because you are 

using an eight-megabyte system or a system that is too heavily loaded. This is 
caused by selection timeouts. The selection timeout value for XView-based 
applications is the time a requesting application will wait for a response from the 
selection holder. In general, the default three- second timeout is sufficient for a 
selection transaction to complete. 

If your selection transactions are failing, increase the default selection timeout to 
10 seconds by putting the following in the . Xdef aults file in your home 
directory and then restarting the OpenWindows session: 

f —-^ 

selection.timeout: 10 
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Complete OPEN LOOK 
Mouseless Model 


Compiling an XView 
Application Statically 


Toolkit/OLIT Issues 

Enter Key on Numeric 
Keypad 


XInput Extension 

Problems When Using 
Monochrome Monitors 


The complete OPEN LOOK Mouseless Model is only enabled when 
OpenWindows.KeyboardCommands is set to FULL. Refer to the XView Pro¬ 
gramming Manual for information. 


If you compile an XView application statically and do not specify -Ic as a 
library to link against, a compiler warning is issued: 


r 



Id: /lib/libc.a(flsbuf.o): 

: _fflush: multiply defined 




) 


The workaround is to specify -Ic as a library to link against. 


If you use the keypad Enter key when the NumLock key is depressed (that is, 
when the keyboard is in numeric mode), it will work as specified. If you try to 
use it when NumLock is not depressed (cursor mode), it will not work correctly. 
To eliminate this problem, add the following to the user’s defaults file for your 
application: 

01itapplication*returnKey: <Return>, <KP_Enter> 

( _ / 


where Olitapplication is the name of the application. 

To make the adjustment for all applications, add the following to . Xdefaults: 

*returnKey: <Return>, <KP_Enter> 

v_ 


OLIT supports the X input extension. Sample code demonstrating its use is 

available on the SUCCESS library (token number 6186). 

Several difficulties may arise when you use a monochrome monitor: 

• FlatExclusives and FlatNonExclusives widget labels disappear 
when the inputFocusColor matches the background color. This prob¬ 
lem is much more likely to appear on a monochrome monitor since there are 
only two colors. 

• When you use a RectButton in mouseless mode on a monochrome moni¬ 
tor, you will not be able to tell if the button is selected or not. Normally, in 
2D mode you can tell if a button is selected because its border becomes bold. 
However when a RectButton receives input focus in mouseless mode, the 
border of the button is removed, preventing you from telling what the button 
state is. 
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• When you use aTextField widget on a monochrome monitor, the line 
and the arrows at the end of each line in the widget may not show up. 

Setting the 
XtNconsirmeEvent 
Resource on a 
ScrollingList Widget. 


If you set the XtNconsumeEvent resource on a ScrollingList widget, 
the callback will never get called. The ScrollingList does not currently 
propagate events to its ListPane child. 


Destroying Popup Widgets If you destroy an unrealized Popup widget which contains a TextEdit widget, 

the program will die with an Xlib error. 

Destroying DrawArea OLIT applications that destroy DrawArea Widgets will crash. 

Widgets 


Setting Checkbox Text Font Setting the font color in the checkbox widget does not have any effect. 

Color 


No Compose Key Light with The Compose key will work correctly in OLIT applications, but the Compose 
OLIT Applications LED on the keyboard will not illuminate when Compose is active. 


Toolkit/TNT Issues 

TNT Demos TNT demos, such as jed and jet, are only available on the "Advanced User 

with Demos" and "Full OpenWindows" clusters. See the OpenWindows Version 
3 Installation and Start-Up Guide for details. 

No NeWS or TNT with 4-bit NeWS and TNT are not supported on a 4-bit visual. 

Visuals 


Color Changes in Workspace Whenever the colormap compaction utility is run it writes a file, . owcolors. 
Properties Pop-up When the server is restarted . owcolors is read to initialize the colormap. 

After the file is read, TNT colormap initialization fails. The symptom of this 
failure is that TNT applications do not respond dynamically when workspace 
colors are changed using the Workspace Properties pop up. 

Menu Repainting At certain times, the SaveBehind feature of TNT menus is erroneously invali¬ 

dated. This invalidation causes repainting of the area under the menu when the 
menu is brought down, instead of repairing the area using the SaveBehind 
feature. 

A patch has been provided with the OpenWindows Version 3 release to minimize 
this behavior. You must copy it manually from the CD-ROM before you can install 
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it. To copy it, make sure that you are running as root and have set 
$OPENWINHOME to the location where you installed the OpenWindows 
software. Then enter the following: 

r . " ^ . " ^ 

example# cp ^p /cdrom/OpenWindows/sun4/etc/NeWS/tnt/inenu_fix,ps $OPENWINHOME/etc/NeWS/tnt 

V_^^ .. . ' _______ " '•• : ;••• ; : \ ■ ■■ 


Replace /cdrom with the appropriate directory if you mounted the CD-ROM 
elsewhere. 

After you have copied the patch by hand, you may install it in one of the follow¬ 
ing ways: 

• Do the following, as root: 

example# psh $OPEMWINHOME/etc/NeWS/tn't/menvi_£ix.ps 

_ ) 

This loads the patch into your running server, but only affects TNT applica¬ 
tions started after installing the patch. If you restart the server, the patch 
must be reinstalled. 

• Append $OPENWINHOME/etc/NeWS/tnt/menu_f ix .ps to your 
$HOME/ .user.ps file. 

This installs the patch each time your server is restarted and affects all TNT 
applications started after the server is restarted. 


ToolTalk Service Issues Due to a problem in ToolTalk 1.0, you should create dynamic message patterns 

for all psignatures and osignatures (static message patterns) listed in your ptypes 
and otypes. Register these dynamic message patterns with 
tt_pattern_register(). Do not use tt_ptype_declare(), which will 
automatically create and register message patterns based on the psignatures and 
osignatures in your ptypes and otypes. There is no problem using ptypes or 
otypes. Ptypes provide a start "string" for the ToolTalk service to automatically 
start your application when it’s needed. 

The static message patterns in your ptype and otypes may be used when a mes¬ 
sage is addressed to an otype or contains instructions to start an application or 
queue the message. If no running process matches the message, the ToolTalk ser¬ 
vice looks at the ptypes and otypes it has read in from the Classing Engine to 
look for a matching static message pattern. 

If you use tt_ptype_declare(), the following problem could surface. If two 
processes have declared the same ptype (using tt_ptype_declare()) in a 
ToolTalk session and one of the processes quits the session, the ToolTalk service 
removes the message patterns for that ptype without checking to see if another 
process has also registered that ptype. This leaves the remaining process with no 
registered message patterns (except those registered dynamically) and as a result, 
the remaining process no longer receives messages that match the patterns con¬ 
tained in its ptype. 
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This problem also affects processes that have different ptypes but their ptypes 
contain a pattern with the same op (operation name). When a process that has 
declared a ptype containing a pattern with the common operation name quits the 
ToolTalk session, the pattern with the common operation name is removed from 
memory. The remaining processes that declared a ptype that also contains the 
common operation name will no longer receive messages that match that particu¬ 
lar pattern. 

The following instructions for creating dynamic patterns that match your static 
patterns are in the form of code templates. Templates are given for ptype and 
otype definitions. In each template strings in o’s denote variables and names in 
[]’s denote optional variables. Refer to the ToolTalk 1.0 Programmed s Guide 
for more information on ptype and otype syntax. 


The general form of a ptype definition is: 


f 

> 

ptype <ptype name> { 


<cat>: 


<scope> <op>(<argl>, ..., <argN>) => [start] 


[queue] [opnum=<opn>]; } 


V 

J 


Repeat the following template for each signature listed in the ptype definition: 


% 
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declare_ptype_signature () 

{ 

Ttjiattern p; 

p = tt_pattern_create0 ; 
if (<cat> == "handle") { 

tt_pattern_category_set(p, TT_HANDLE); 

} else if (<cat> == "observer") { 

tt_pattern_category_set(p, TT_OBSERVE); 

} 

if (<scope> == "session") { 

tt_pattern_scope_add(p, TT_SESSION); 

} else if (<scope> == "file") { 

tt_pattern_scope_add(p, TT_FILE); 

} else if (<scope> == "both") { 

tt_pattern_scope_add(p, TT_BOTH); 

} else if (<scope> == "file_in_session") { 
tt_pattern_scope_add(p, 

TT_FILE_IN_SESSION); 

} 

tt_jpattern_op_add(p, <op>); 
if (opnum is listed) { 

tt_pattern_opnum_add(p, <opn>); 

} 

tt_pattern_address_add(p, TT_PROCEDURE); 
if (start is listed) { 

tt_pattern_disposition_add(p, 

TT_START); 

} 

if (queue is listed) { 

tt_pattern_disposition_add(p, 

TT_QUEUE) ; 

} 

/* optionally, you can add a callback since 
this is a dynamic pattern*/ 
tt_pattern_register(p); 

} 

\_ 


This example shows how to create a dynamic pattern for the third message pat¬ 
tern listed in Sun_EditDemo’s ptype. Sun_EditDemo is a sample program stored 
in $OPENWINHOME/ share/src/tooltalk/. The ptype is listed in the 
edit. type file in this directory. 
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/* 

* pattern corresponding to ptype signature: 

* f ile_in_session Sun_EditDertlo_save_as (in 

* string new_filename) 

* => opnuin=SUN_EDITDEMO_SAVE_AS; 

*/ 

de c1a re_pt ype_signatu re() 

{ 

Tt_pattern p3; 


p3 = tt_j3attern_create 0 ; 
tt_pattern_category_set(p3, TT_HANDLE); 
tt_pattern_scope_add(p3, 
TT_FILE_IN_SESSION); 
tt_pattern_op_add(p3, 
"Sun_EditDemo_save_as"); 
tt_pattern_opnum_add(p3, 
SUN_EDITDEMO_SAVE_AS); 

tt_pattern_address_add(p3, TT_PROCEDURE); 
tt_pattern_arg_add(p3, TT_IN, "string", 
(char *)0); 


} 


tt_pattern_register(p3); 


The otype message pattern definition is similar to the ptype definition. Use this 
template to provide otype message patterns. 

otype <otype_name> { 

<cat>: 

<op>(<argl>, ..., <argN>) => <ptid> 

[<scope>] [start] [queue] [opnum=<opn>]; }; 

V_ 


Repeat the following for each signature listed in the otype. 


#sun 

microsystems 


Revision A of December 1991 





10-44 SunOS 4.1.2 Release Manual 


declare_otype_signature () 

{ 

Tt_jpattern p; 

p = tt_pattern_create0; 
if {<cat> == "handle") { 

tt._pattern_category_set (p, TT_HANDLE) ; 

} else if (<cat> == "observer") { 

tt_pattern_category_set(p, TT_OBSERVE); 

} 

if (<scope> == "session") { 

tt_pattern_scope_add(p, TT_SESSION); 

} else if (<scope> == "file") { 

tt_pattern_scope_add(p, TT_FILE); 

} else if (<scope> == "both") { 

tt_pattern_scope_add(p, TT_B0TH); 

} else if (<scope> == "file_in_session") { 
tt_pattern_scope_add(p, 

TT_FILE_IN_SESSION); 

1 

tt_pattern_op_add(p, <op>); 
if (opnum is listed) { 

tt_pattern_opnum_add(p, <opn>); 

} 

tt_pattern_otype_add(p, <otype_name>) 
tt_pattern_address_add(p, TT_0TYPE); 
tt_pattern_address_add(p, TT_0BJECT); 
if (start is listed) { 

tt_pattern_disposition_add(p, 

TT_START); 

} 

if (queue is listed) { 

tt_pattern_disposition_add(p, 

TT_QUEUE); 

} 

/* optionally, you can add a callback since 
this is a dynamic pattern*/ 

tt_pattern_register(p); 

} 

V_ 


This example shows how to create a dynamic pattern for the message pattern 
listed in Sun_EditDemo’s otype. The otype is listed in the edit. type file in 
the $OPENWINHOME/share/src/tooltalk directory. 
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- -—-. 

/* 

* pattern corresponding to otype signature: 

* hilite_obj(in string objid) 

* => Sun_EditDemo file_in_session start 

* opnum=SUN_EDITDEMO_HILITE_OBJ; 

*/ 

declare_otype_signature () 

{ 

Tt_pattern p5; 

p5 = tt_pattern_create(); 
tt_pattern_category_set(p5, TT_HANDLE); 
tt_pattern_scope_add(p5, 

TT_FILE_IN_SESSION); 

tt_pattern_op_add(p5, "hilite_obj"); 
tt_pattern_opnuin_add (p5, 

SUN_EDITDEMO_HILITE_OBJ) ; 
tt_pattern_otype_add(p5, 

"Sun_EditDemo_object"); 
tt_pattern_address_add(p5, TT_OTYPE); 
tt_pattern_address_add(p5, TT_OBJECT) ; 
tt_pattern_disposition_add(p5, TT_START); 
tt_pattern_arg_add(p5, TT_IN, "string", 

(char *)0); 

tt_pattern_register(p5); 

} 

V_ ) 


If arguments are listed in either the ptype or otype signature, use this template to 
add them to the pattern: 

Case 1: 


r 


<op> 0 


V 

) 


This case specifies that argument matching is not required for this signature so no 
action needs to be taken. 

Case 2: 


. - 


<op>(void) 


V 

__ ) 


This case specifies that this signature takes no arguments. No action is required. 
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Case 3: 

<op>(<model> <typel> <namel>, ...,<modeN> 

<typeN> <nameN>) 
if (<mode> == "in") { 

tt_pattern_arg_add(p, TT_IN, <type>, (char 
*) 0 ) ; 

} else if (<mode> == "out") { 

tt_pattern_arg_add(p, TT_0UT, <type>, (char 
*) 0 ) ; 

} else if (<mode> == "inout") { 

tt_pattern_arg_add (p, TT__IN0UT, <type>, (char 
*) 0 ); 

} 

I_ y 


In this case, you need to add arguments to the dynamic pattern. For an example 
of this, see the Sun_EditDemo ptype example. 


Supplemental 

Documentation 


The following sections are supplements to the OpenWindows Version 3 docu¬ 
mentation. 


News Programming: NeWS 
Operators 


-N 

canvas reshapecanvas - 
canvas path reshapecanvas - 
canvas borderwidth reshapecanvas - 
canvas path borderwidth reshapecanvas - 
v_ 


The, correct definition of the reshapecanvas operator differs from the 
definitions given in the NeWS 3.0 Programmer’s Guide and in the OpenWindows 
Version 3 Release Manual. Most of the changes occur in the paragraphs regard¬ 
ing the X Shape Extension. The following is the correct definition for 
reshapecanvas: 


If a canvas argument alone is specified, this operator sets canvas’s shape to be 
the same as the current path, and sets canvas’s default coordinate system to be 
the same as the current coordinate system. This results in a new canvas transfor¬ 
mation matrix. If the current path is empty, with canvas as the only argument, 
this operator has no effect. 

If canvas is the current canvas, an implicit initmatrix and initclip are 
performed, initmatrix sets the current transformation matrix to be the same 
as the new canvas’s transformation matrix, initclip sets the current context 
clip path to be the same as the new canvas’s shape. An implicit newpath is 
always performed to clear the current path. 
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If the current path is non-rectangular and the only argument, canvas, is an X can¬ 
vas, canvas's X Shape Extension is activated by setting canvas's client bounding 
region to be the same as the current path and canvas's default bounding region to 
be the same as the bounding box of the current path. Canvass effective bounding 
and/or clip regions are recomputed properly. 

Canvas's default bounding region is the rectangular area that covers both 
canvas's client drawable interior and its border (as described in the X core proto¬ 
col). Canvas's default clip region is canvas's default bounding region without the 
border. Canvas's client bounding region is the client-defined bounding region, 
which can be non-rectangular. Canvas's client clip region is the client-defined 
clip region, which can be non- rectangular. Canvas's effective bounding region is 
the intersection of canvas's default bounding region and client bounding region. 
Canvas's effective clip region is the intersection of canvas's effective bounding 
region, default clip region, and client clip region. These regions maintain con¬ 
stant distances from canvas's X default origin, which is the upper left comer of 
canvas's default clip region. See the XU Non-Rectangular Window Shape 
Extension (MIT X Consortium Standard Version 1.0, Copyright 1989 by the 
Massachusetts Institute of Technology) for more information. 

If the current path is rectangular and the only argument (canvas) is an X canvas, 
then canvas's default bounding region is set to be the same as the current path. In 
this case, if canvas's X Shape Extension is activated (i.e. if canvas has a client 
bounding region and or a client clip region), then canvas's effective bounding 
and or clip regions are recomputed properly. 

The path and or borderwidth arguments can be used only if canvas is an X can¬ 
vas, otherwise this operator results in a typecheck error. 

A non-empty current path and path activate canvas's X Shape Extension (if it is 
not activated already) by setting canvas's client bounding region to be the same 
as path. If the current canvas is different from the context canvas used when 
forming path, then path is pre-translated such that its distance to the upper left 
comer of the current canvas’s default bounding region is the same as its previous 
distance to the upper left corner of its context canvas default bounding region. A 
non-empty current path and empty path result in the removal of canvas's client 
bounding restriction. Canvas's effective bounding and/or clip regions are recom¬ 
puted properly. 

An empty current path and path activate canvas's X Shape Extension (if it is not 
activated already) by setting canvas's client clip region to be the same as path. If 
the current canvas is different from the context canvas used when forming path, 
then path is pre-translated such that its distance to the upper left comer of the 
current canvas’s default bounding region is the same as its previous distance to 
the upper left corner of its context canvas default bounding region. An empty 
current path and an empty path result in canvas's client clip restriction being 
removed. Canvas's effective clip region is recomputed properly. 

borderwidth resets canvas's default clip region and recomputes canvas's effec¬ 
tive clip region properly. 


♦sun 

microsystems 


Revision A of December 1991 



10-48 SunOS 4.1.2 Release Manual 


TNT: Drag-and-Drop 
Changes 


ClassSelection 


The following sections contain changes to ClassSelection, and ClassTextCanvas 
that didn’t get included in the NeWS Toolkit Reference Manual. In addition, a 
new class, ClassTextSelection, is introduced below. 


ClassSelection has a new variable and a new method that are used to implement 
drag and drop animation. 

/DragCursorType (Variable) 

Determines how /setdragimage (below) combines the drag-and-drop pointer 
glyphs with an application-specific image. The legal values are: 

/Sourcelmage: Center the application image around the pointer glyph 

/Boxed: Place the application image in the ‘flying punchcard’ box. /Boxed is the 

default. 

/Sourcelmage drags should be used when dragging a whole object, e.g., an entire 
file. /Boxed drags should be used when dragging a portion of a larger object (e.g., 
some text from a file, one object from a drawing). 


cursorimage maskimage /setdragimage - 

Builds a drag-and-drop pointer using cursorimage and maskimage. cursorimage 
and maskimage can only be 1-bit deep canvases. Both cursorimage and maskim¬ 
age must be given, but they can be the same canvas. The value of /DragCursor¬ 
Type (above) determines how the application-specific image and the drag-and- 
drop pointer glyphs are combined, /setdragimage is typically called from the 
/DragStart method. 

The Toolkit provides two ways to set the drag-and-drop pointers for an applica¬ 
tion selection: 

• Use /DragCursorType and /setdragimage to combine an application- 
specific image with the default pointer glyphs. ClassTextCanvas uses this 
combination to provide the flying punchcard text drag cursor. This is also the 
easiest way to merge application-specific images with the OPEN LOOK drag- 
and-drop pointer glyphs. 

• Override the drag-and-drop pointer class variables in your ClassCanvas sub¬ 
class. There are eight pointer variables that you can override: /InsertMo- 
veCursor, /InsertCopyCursor, /RepIaceMoveCursor, /ReplaceCopyCur- 
sor, /NeutralMoveCursor, /NeutralCopyCursor, /InvalidMoveCursor, 
and the /InvalidCopyCursor. Overriding the canvas variables is a good 
mechanism if your drag-and-drop cursors aren’t likely to change from 
instance to instance. OpenWindows has an OLcursor font that contains pre¬ 
defined cursors that cover several of the most common source image cases. 

For more information on drag-and-drop pointers see the OpenWindows Version 3 
Desktop Integration Guide. 
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ClassTextSelection 


C lassTextCanvas 


ClassTextSelection subclasses ClassSelection to set defaults and provide 
definitions for several ClassSelection subclass responsibility methods. 
ClassTextSelection does the following: 

• Sets the default /DragCursorType to be /Boxed 

• Sets the default cursors to be empty ‘flying punchcard’ cursors. 

• Creates the /CanRenderAs dictionary with /ContentsAscii, /Con- 
tentsPostScript, and /SelectionObjsize as the keys. The value for each key is 
a proc that obtains the requested value. The proc executes during a call to 

/SingleRequest. 

• Creates a dictionary named /ActionRequests. /ActionRequests is similar to 
/CanRenderAs but contains those requests with side-effects instead of 
values. Default requests are /DeleteContents and /Canvas. The /Canvas key 
does not denote an action, but it can’t go into /CanRenderAs because of the 
possibility of creating a sticky window if the selection is copied to the clip¬ 
board. 

• Overrides /AllRequests to return a diet that combines /CanRenderAs and 
/ActionRequests. 

• Overrides /Deselect to forward /Deselect to the Holder of the selection. 

• Overrides /SingleRequest to expect the value from /CanRenderAs or 
/AllRequests to be the proc to execute to obtain the value. 

ClassTextCanvas has changed to reflect the new drag-and-drop implementation. 
ClassTextCanvas subclasses ClassCanvas to provide assistance for clients whose 
selections are character strings and who want use the standard OPEN LOOK 
semantics for dragging and dropping text. ClassTextCanvas is Selectable, sets 
/SelectableType to be /Text, and defines /DragStart. You still must provide the 
definitions for the other selectable subclass responsibility methods in ClassCan¬ 
vas. 

Creation 

parentcanvas /new instance 
Creates a text canvas. 

Drag Methods 

event selection /DragStart - 

Creates a text drag cursor that contains part of the selected text, 
selection /CurrentText string 

Obtains the text to display in the overlay canvas. Subclassers will generally wish 
to override the /CurrentText method for greater efficiency (the default uses the 
normal /query mechanism whereas individual subclasses can usually obtain the 
text by more direct methods). 
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Running OpenWindows via xdm(l), the X display manager, is used to control a collection of both local and 

xdm remote displays, and is typically started by root. When OpenWindows runs via 

xdm, you see a login window on the screen, welcoming you to the system and 
asking for your username and UNIX password. The login capability is very rudi¬ 
mentary, in that a user’s configuration files, such as . login and . cshrc or 
. profile are not executed. 

After you successfully log in, xdm starts up your X environment, typically by 
reading the executable file named .xinitrcin your home directory, and runs 
an Xsession. On exiting from the window system, the window server is restarted 
by the xdm daemon. 

A configuration file is usually provided to xdm at start-up. This file is used for 
initial xdm set-up. This file also contains pointers to other shell scripts used in by 
xdm. xdm is typically started by root. The user environment for root must be 
set-up correctly, as follows: 

# set $OPENWINBOME /usr/openwin <or other location of OpenWmdows> 

# set path s ( $OPENWINHOME/bin $path ) 

# setenv LD_LIBRARY_PATH $OPENWINHOME/lib:/usr/lib 

V __________ 


A typical command line, where the configuration file is provided to xdm at start¬ 
up is as follows: 

# xdm ■’COnfig $OP£KWIRHOME/lib/xdm/xdm~con£ig 


By default, xdm looks in /usr/openwin/lib/xdm to find the configuration 
files it requires. The configuration file and other shell scripts used by xdm are in 
$OPENWINHOME/lib/xdm. It is suggested that you start with this set of files 
if you wish to change the behavior of xdm. From its original XI1R4 version, 
xdm has been modified slightly to allow it to work more efficiently with the 
OpenWindows XI 1/NeWS server. When started by root, xdm executes a window 
server which is listed in the file, Xservers. Once the server has initialized 
itself, the login window through which a user may log into the system displays. 

xdm Files The following are some of the files used in conjunction with xdm: 

• $OPENWINHOME/lib/xdm/xdm-config 

This file is used by xdm; see the man page for more information. 

• $OPENWINHOME/lib/xdm/Xservers 

This file lists which server to run and whether to run local or remote: 

;0 Local local $OPENWINHOME/lib/xdm/StartOW :0 

• $OPENWINHOME/lib/xdm/StartOW 

This file contains the shell script used to pass the correct arguments to the 
OpenWindows server. 

• $OPENWINHOME/lib/xdm/Xsession 

This file runs as the client for the display manager. It attempts to run a per- 
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user . xinitrc. It also forces the window server to change its userid to 
that of the new user. 
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Part 5 — Appendixes 


Part 5 consists 

• Appendix 

• Appendix 

• Appendix 

• Appendix 


of the following appendixes: 

A, “Documents Available for Use with SunOS 4.1.2” 

B, “Addendum to Writing Device Drivers” 

C, “Sundiag version 2.3 for SunOS 4.1.2” 

D, “X/Open Conformance Statement (XCS-QUE-3.106)” 




Part 5 — Appendixes — Continued 




Books: User’s Guides 


Binder: System and Network 
Administration 


Books: OpenWindows End User 
Manuals 


Binders: SunOS Reference 
Manual (3 Volumes) 



Documents Available for Use with 

SunOS 4.1.2 

An extensive collection of software manuals is made available for use with 
SunOS 4.1.2. The manuals are shipped in binders that may contain one or more 
documents. The following describes the contents of the binders following the 
general order of use. This release manual and Installing SunOS System Software 
were described in Chapter 1, and are not listed here. 


These brief manuals are easy to read, written for the user with little or no UNIX 
experience. Getting Started is for those new to the Sun environment. Other titles 
are Doing More with SunOS, Basic Troubleshooting, SunView User’s Guide, and 
Customizing Your Environment. The SunDiag User’s Guide is in the same box, 
but is written for users who will be testing memory, drives, boards, and board- 
level devices with SunDiag. 


The System and Network Administration manual is written for system administra¬ 
tors, but is a valuable resource for all SunOS users. It deals with adding 
hardware, disk maintenance, networking and electronic mail service, and 
advanced UNIX administration. 


This is a set of four guides for the user who is new to OpenWindows: 

OpenWindows Version 2 User’s Guide 
DeskSet Environment Reference Guide 
OpenWindows Version 2 Release Notes 
OpenWindows Version 2 Installation & Start-Up Guide 


This set of binders contains the SunOS version of the Berkeley UNIX man pages, 
alphabetically arranged descriptions of commands, functions and other aspects of 
SunOS 4.1.* Numbered tabs divide the Reference Manual into a range of topics, 
as listed below: 

1. User Commands 


* New man pages for SunOS 4.1.2 are included in the release box. 
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2. System calls and error numbers 

3. User-level library functions 

4. Devices, drivers, protocols and network interfaces 

5. File formats used or read by various programs 

6. Games and demos 

7. Public files, tables and TROFF macros 

8. System maintenance and operations commands 


Binder: Global Index 


Provides an index to SunOS 4.1 software documentation. It is not updated for 
SunOS 4.1.1, SunOS 4.1.1 Rev B, or SunOS 4.1.2. 


Binder: SunOS Documentation Editing Text Files covers the editors vi, ex, ed, and sed. Formatting Documents 

Tools explains special formatting macros that work with TROFF such as refer, index¬ 

ing, table formatting and equation setting. Using TROFF and NROFF explains the 
use of those text processing utilities. 


Binder: Programmer's Guides This group of manuals focuses on programming within the Sun environment, for 

both systems and applications level interests. 

C Programmer's Guide describes how to write C programs that interface with 
SunOS. Assembly Language Reference Manual for Sun-3 and Assembly 
Language Reference Manual for Sun-4 covers syntax and usage of the assembler 
for some of the microprocessors used in Sun workstations and servers. A RISC 
Tutorial looks at the aspects of RISC and open systems architectures as they per¬ 
tain to SPARC architecture. Porting Software to SPARC Systems briefly describes 
machine level SPARC architecture, and porting C, FORTRAN, and Pascal pro¬ 
grams to a SPARC system. The Debugging Tools Manual describes the 
debuggers dbx, dbxtool , and adb for experienced programmers. 

Binder: Programmer's The System Services Overview contains details of various specialized aspects of 

Overview Utilities and Libraries SunOS operating system, including internationalization, security features, net¬ 
working, and UNIX standards compatibility. Programming Utilities and 
Libraries is written primarily for applications programmers to provide an over¬ 
view of the Sun environment, and the system facilities, utilities, and libraries 
supported. 


Binder: Network Programming The Network Programming Guide provides an overview of NFS, pipes, sockets. 
Guide network commands. Sun online database service, and network managers and 

monitors. 
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Binder: Writing Device Writing Device Drivers is a guide to adding drivers for new hardware devices to 

Drivers/STREAMS Programming the SunOS kernel. The STREAMS Programming manual covers the theory of 

STREAMS programming, the SunOS-specific implementation, and catalogs 
STREAMS functions and data structures. 


Binder: SunView SunView 1 Programmer’s Guide is written for applications programmers to sup- 

Programmer’s Guide port interactive, graphics-based applications running within windows. The Sun¬ 

View 1.80 Update Appendix updates the SunView 1 Programmer’s Guide with 
the latest information. 


Binder: SunView 1 System The SunView 1 System Programmer’s Guide describes how SunView works from 

Programmer’s Guide the inside, and how to structure applications. The Pixrect Reference Manual 

describes the Pixrect graphics library routines that manipulate arrays of pixel 
values, and RasterOps used by applications programs to manipulate bit-mapped 
displays. 
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B 


Addendum to Writing Device Drivers 


This addendum has two parts: 

• Sun-4m Device Driver Developer Notes 

• SunOS 4.1.1 Changes 

B.l. Sun-4m Device Driver Due to architectural differences between bOOMP and previous Sun machines, 
Developer Notes there are few key points that device driver developers must be aware of: 

• 600MP supports both VME and SBus. There is also an I/O cache (IOC) (which 
actually behaves more like a write buffer) on the VME bus interface. 

• 600MP has a separated lOMMU which is capable of doing "coherent dvma" 
with respect to the CPU caches. 

With a separated lOMMU, DVMA mappings are now independent of the host 
SRMMU mappings. This means that by default a DVMA address should be con¬ 
sidered as only valid from the point of view of devices that will be doing DVMA, 
and it should be considered invalid from the point of view of a CPU (and your 
driver, since it runs on a CPU). Similarly, a host SRMMU virtual address should 
not be used by a device to perform DVMA. 

As a result of the these new features, 600MP supports at least 16MB (also 
default) of DVMA space. This DVMA space is divided into 4 regions (maps): 

vme24map: despite its name, a vme32 device can use this map too. This 
is the default map for all VME devices. This map is about 1MB. 

vme32map: only vme32 devices can use this map. This map is about 6MB. 

sbusmap: default map for SBus devices. This map is about 1MB. 

bigsbusmap: an optional map for SBus devices. This map is about SMB. 

NOTE: although there are now four maps, for compatibility reasons, a VME 
driver should still use mb_hd. mh_map as an argument to the mb_XXX routines. 
Similarly, SBus devices should use dvmamap to interface with the mb_XXX rou¬ 
tines. See “Performance Tuning” below for information about using the larger 
vme32map and bigsbusmap. 
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Compatibility 


Most drivers can probably run on a 600MP series machine without recompila¬ 
tion, but some may require some modifications. The following is a list of points 
to consider to determine if a existing driver is portable to a 600MP series 
machine: 

• Does the driver use only standard driver supporting routines provided by the 
kernel, such as mb_mapalloc/mb_mapf ree (and their mb_XXX varia¬ 
tions) to manage DVMA mappings? 

Note: segkmem_XXX and hat_XXX are not considered as standard driver 
supporting routines. 

If your driver uses non-standard routines to set up DVMA mappings, it most 
likely will NOT work on a 600MP series machine (since mb_XXX routines 
are the only routines that set up DVMA mappings on the lOMMU) These 
drivers MUST be converted over to use the standard mb_XXX routines if 
they are to be portable. 

• Does the driver use DVMA[some_offset] to reference/modify data inside the 
DVMA data transfer buffers? 

If the answer is yes to this question, then: 

• if it is a VME device, it will run as is. However, it is advised that the driver 
should use bp_mapin() and bp_mapout() routines for better portability. 

• if it is an SBus device, you need to convert it to use 

bp_mapin () /bp_mapout(). Otherwise, the driver will pick up random 
values. 

This is due to the fact that DVMA addresses are now independent of the host 
SRMMU virtual address. For compatibility reasons, the DVMA mappings in 
vme24map (default map for vme devices) is set up such that DVMA[] refer¬ 
ence would still work. However, the same thing can not be done on the SBus 
maps, so it is no longer compatable with other Sun machines. 

• Does your VME device run with IOC off? 

IOC only works on VME devices. IOC is turned on/off, flushed automatically 
by the mb_mapalloc () /mb_mapf ree(). Currently, there is no easy way 
for a driver to disable IOC. 

• Does the driver use the ioc_f lush() macro to flush lOC? 

If yes, the driver needs to be recompiled on a SPARCsystem 600MP series 
machine; the binary will not be portable to other machines. 

Other than the points listed above, a driver should be written exactly the same 
way as if it were written for other machines. A driver written for 600MP series 
machines should work for the other machines but not necessarily vice versa since 
the rules for 6(X)MP are more restrictive. The only exception to this rule is if your 
driver uses non-default, large DVMA maps which are not supported on other 
machines (see “Performance Tuning”). 
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Interrupts 


Write Buffers 


Performance Tuning 


Hardware interrupt levels for Sun-4m are different than for Sun-4 or Sun-4c. 
Refer to the Sun-4m System Architecture document for details. 

The Sun-4m mapping of SBus and VMEbus interrupt levels to SPARC interrupt 
request level (IRL) is different from previous Sun-4 and Sun-4c architectures. A 
device which interrupts at SBus level x, which is mapped by the onboard inter¬ 
rupt logic to SPARC IRL y on Sun-4 or Sun-4c, will now be mapped to SPARC 
IRL z on Sun-4m and z may be greater than y. This may introduce bugs which 
typically manifest themselves as corrupted data structures leading to kernel 
crashes. 

For Sun-4m, device drivers should not make Networking or STREAMS framework 
function calls while operating at SPARC IRL levels higher than IRL 7 (splimp) 
for networking, or IRL 10 (splstr) for STREAMS. Doing so circumvents the 
interrupt masking being done by the networking and STREAMS subsystems them¬ 
selves and risks data structure corruption. Device drivers should do minimal pro¬ 
cessing at high interrupt levels and schedule a software interrupt for further inter¬ 
rupt processing, including interacting with other portions of the kernel. 

For Sun-4m, it is OK to call networking and mbuf utility routines while servicing 
a device interrupt at VME and SBus levels 4 and below. It is OK to call STREAMS 
utility routines at VME and SBus levels 5 and below. 

In general, device drivers which support multiple devices which interrupt at more 
than one hardware interrupt level must take precautions to service only those 
interrupts at the "current" interrupt priority level (via spltoipl() ) in order to 
avoid race conditions which result in the error message “Level XXX BBB inter¬ 
rupt not serviced.” 


Write buffers are used to accelerate writes and reduce bus occupancy for better 
overall system performance. Write buffers exist both for programmed I/O and 
DVMA activity. Use of the mb_xxx() routines guarantees correct operation. All 
write buffers in the Sun-4m architecture follow these rules; 

• Once a write buffer has accepted a write, it must either guarantee that the 
write can occur without error, or the write buffer is responsible for reporting 
those errors, 

• Write buffers are read-stall; that is, after a write buffer has accepted a write, 
any subsequent access to that device must wait for the write operation to 
complete (order is maintained). Although write buffers are not visible to 
device drivers, their effect may be. While order is maintained, the relative 
timing of writes to the device may be significantly different from the issuing 
(CPU) timing. 

To optimize the performance for drivers running on 600MP series machines, 
drivers can do the following: 
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vme32 devices 


SBus Devices 


lOMMU Bypass Mode 


SBus Slot Configuration 
Register 


Open Boot PROM 


If the driver does not peek inside the DVMA data buffers without 

bp_mapin () /bp_mapout(), it may set the MDR_VME32 flag to use the much 

larger vine3 2map, instead of the smaller default vme2 4map. If the DVMA 

request size is not larger than 1MB, adding this flag should not cause problems in 

terms of portability. It will be simply ignored by machines that do not have this 

map. 

SBus devices can set the MDR_BIGSBUSMAP flag to use the big SMB map. If it 
uses the big map, it must NOT add the DVMA base to form the DVMA address 
passed to the device. Mb_mapalloc() already returns a correct "ready to use" 
DVMA address. Usage of this map makes the driver NON-portable. 

NOTE: driver should not use vme3 2map or bigsbusmap as arguments to the 
mb_XXX routines. Instead, use flags as described. 

If a driver uses lOMMU bypass mode, it will be responsible for its own DVMA 
mappings. The standard DVMA supporting routines described above will not be 
useful for them. 

There is an SBus slot configuration register for each SBus slot in the system. 

Each SBus slot configuration register provides information about the slave device 
in that slot (slave support for 64-, 32-, 16-, and 8-byte bursts), and is also used for 
lOMMU bypass management for that slot. The boot code is expected to configure 
the slot based upon FCodes associated with the SBus device. Refer to the Open 
Boot PROM V2 Reference Manual. Failure of the device firmware FCode to sup¬ 
port this property will result in less than optimal slave access performance for the 
device as only 4-byte word sized slave transfers will be used. 


SPARCsystem 600MP is released with version 2 of the open boot PROM 
firmware. Refer to the OBP V2 Reference Manual for details. 
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B.2. SunOS 4.1.1 Changes This appendix is an addendum to Writing Device Drivers for Sun Workstations-, it 

replaces a similar document which was distributed with the SunOS 4.1 PSR 
A Release Manual. It contains important information if you are planning to 
implement an I/O device driver for a DVMA device that runs on a machine with an 
I/O Cache (lOC). Machines with an I/O cache include the Sun3/4X0 series (Sun- 
3/460, Sun-3/470, Sun-3/480) and the SPARCsystem 4X0 series (SPARCsta- 
tion470, SPARCserver470, SPARCserver 490). 

The IOC provides a Write-Back buffer for VME I/O devices capable of initiating 
accesses to Main Memory. On Sun machines, I/O devices use virtual addresses 
for memory access. Direct Memory Access using virtual addresses is referred to 
as DVMA, and devices capable of initiating DVMA are called DVMA devices. 

The SPARCsystem 4X0 IOC consists of 128 sets of 32-byte-wide data buffers. 
The Sun-3/4X0 lOC consists of 128 sets of 16-byte-wide data data buffers. 

Except for this difference, the two caches are identical. The following descrip¬ 
tion will assume the SPARCsystem 4X0 IOC. 

Each data buffer corresponds to an 8K page, so that serial transfers through a par¬ 
ticular DVMA page are buffered into 32-byte blocks on their way to or from 
memory. For example, a DVMA write to memory will use the same IOC buffer 
repeatedly as it serially transfers a page: each 32-byte block on the page is 
flushed to memory by the next 32-byte block on the same page. At the end of 
each such DVMA write there will be one line in the lOC for each page of the 
transfer that will contain valid data that has yet to be written to memory. 

The IOC is designed to buffer data into blocks to make long serial transfers more 
efficient. When an IOC line is flushed, all 32 bytes are flushed, even if some 
bytes of the line were not modified. Despite its name, the IOC is really a buffer. 
When transferring from a device to memory the cache line is not filled from 
main memory before the line is updated with data from the device. This makes 
using the IOC appropriate for buffering data transfers, but inappropriate for 
buffering I/O control block information which is shared between the device and 
the CPU. 

Drivers allocate and release DVMA using mb routines described in the Writing 
Device Drivers manual. The kernel mb routines generally account for the pres¬ 
ence of the IOC in ways that will be transparent to the driver. This mechanism is 
detailed here so an implementer can decide if it is suitable for a particular driver. 

The kernel mb routines enable the Sun3/4X0 and SPARCsystem 4X0 lOCs for a 
particular buffer using the criteria shown below. 


if (bp->b_flags & B_READ) { 

if ((((u_int)bp->b_un.b_addr & IOC_LINEMASK) == 0) && 

((bp->b_bcount & IOC_LINEMASK) == 0)) 
set_ioc = 1; 

else /* misaligned */ 
set_ioc = 0; 

} else /* B_WRITE */ 
set_ioc = 1; 

V_/ 
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Header File Inclusion 


If the starting address of the transfer is on an I/O cache line boundary, i.e., the 
address is a multiple of the constant ioc_linesize and the length is also a multi¬ 
ple of ioc_LiNESizE, the IOC is used. Note that all writes are I/O cached as writes 
correspond to reads by DVMA devices, which entail no flushes and have no align¬ 
ment requirements (extra bytes may be loaded from memory into the lOC, but the 
DVMA device gets only bytes from the addresses it requests from the IOC and 
there is no chance for corruption of data). 

Upon release of the I/O cached DVMA space the kernel mb routines will flush any 
remaining data left in the IOC. This means that a driver for a device that performs 
DVMA in a serial fashion to aligned buffers will automatically make use of the 
IOC without requiring any code changes. 

There are some special cases: 

• What if I want a driver to use the IOC even though transfers aren’t properly 
aligned? 

In some cases, for instance DVMA to a buffer in user space, the alignment of 
the buffer into which data is received can’t be changed and you can not force 
the IOC to be used. In other cases, for instance DVMA to a buffer managed by 
the driver itself, the buffer can be appropriately manipulated so the criteria 
for use of the IOC is met. This is generally done by allocating 
ioc_LiNESiZE-l more bytes of DVMA than needed and rounding up the 
starting address to be aligned with ioc_linesize. Also the size of the 
DVMA requested is rounded up to ioc_linesize even though the amount 
actually DVMA’d may be less. 

• What if I don’t want the lOC to be used? 

The I/O cache can be turned off for a DVMA transfer by making sure the 
pg_ioc bit in a DVMA page’s Page Table Entry (PTE) is set to zero. This 
should be done after DVMA space is allocated with the kernel mb routines but 
before any DVMA has occurred. The pg_ioc bit should be cleared for each 
page of DVMA involved in a transfer. 

Note that on a sun3x, this is the pte_iocache bit. 

• What if DVMA space is reused without releasing and reallocating it with the 
kernel mb routines? 

In this case either the transfer can be set up so the IOC is not used or the IOC 
can be manually flushed at whatever points are necessary to insure all data 
has reached memory. Flushing the I/O cache is accomplished with use of the 
ioc_f lush () macro. The argument to ioc_f lush () is the page offset 
into DVMA for the transfer. If the transfer spans more than one page then 
ioc_f lush () will need to be called for each page. 


Drivers that use either the ioc_linesize constant or the ioc_f lush () macro 
should include the machine/ iocache. h header file. Proper inclusion is 
shown in the code fragment example below. 
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Manual IOC Flush Example In the following code fragment example, the IOC is being manually flushed for a 

range of DVMA addresses following a transfer. dvma_addr is the byte offset 
into DVMA for the transfer. dvma_count is the number of bytes the device 
transferred. 

#ifdef IOC 

#include <inachine/iocache.h> 

#endif IOC 

#ifdef IOC 

if (ioc) { 

end_addr = dvma_addr + dvma_count; 

for (addr = dvina_addr; addr < end_addr; addr += MMU_PAGESIZE) { 
linenum = (addr » MMU_PAGESHIFT) & (IOC_CACHE_LINES - 1); 
ioc_flush(linenum); 

} 

} 

#endif IOC 


Changes Since Earlier As of SunOS 4.1 and SunOS 4.1 PSR A, the code for managing the Sun-3/470 

Releases lOC and the SPARCsystem 4X0 IOC was inconsistent. In SunOS 4.1.1, Sun3x 

IOC management was changed to be compatible with Sun4 lOC management. 

This means that drivers compiled to use the SunOS 4.1 b_iocache flag to use the 
Sun3x IOC will not compile under 4.1.1. 
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Sundiag version 2.3 for SunOS 4.1.2 


The Sundiag diagnostic program, version 2.3, is shipped with SunOS 4.1.2. A 
brief description of the version 2.3 enhancements follows; see the Sundiag 2.3 
User’s Guide - SunOS 4.1.2 (Part Number 800-6020-10) for details. 

NOTE: Sundiag currently does not run with the OpenWindows window inter¬ 
face. If you are running OpenWindows, exit the window system before starting 
Sundiag. Sundiag will work with Sunview windows. 

The Sundiag diagnostics program includes a variety of new tests and features for 
SunOS 4.1.2. Tests for Sun’s new hardware include the following: 

• Multi-Processing CPUs (details below) 

• Graphics Tower 

• SunVideoPix 

• Sunlink HSI 

• DRI/S boards 

• Serial Parallel Controller 

• Prestoserve 

• SBus Printer cards 

• eg 12 (GS) Graphics Accelerator Board 
The following existing tests have been enhanced: 

• kmem 

• nettest 

• rawtest 

• fstest 

• sunlink 

The following options have been added to the Sundiag program: 

-w Writes the system hardware configuration to 

the /usr/adm/sundiaglog/sundiag. conf file. 
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-b Allows you to run Sundiag in batch mode. In order to use this option, 
you must first create a batch_f ile in 
/usr/diag/sundiaglog/conf igs before using Sundiag. 

The batch_f ile must use the following format; 


#option file 

runtime 

delay_before_loading_next_option_file (min.) 


optfilel 

60 

3 


optfile2 

1020 

5 


optfilel 

60 

16 


optfile3 

0 

0 



opt filei and optf ile2 are files containing Sundiag tests. They will 
run for the times specified (in minutes) in the runtime column. Files with a 
runtime of 0 display the final status of tests that have already run. This 
feature can be used to give the status of of some or all of the option files in 
the options_file. 

The delay_bef ore_loading_next_option_f ile is required to 
ensure that all tests have been stopped before the next option file is loaded. 


The settings in the Sundiag Options Menu override the settings in the batch 
files. Use larger values in the Options Menu when using batch files and 
avoid using the single pass values. 

C.l. Sundiag for the The new Sundiag multi-processor test, mptest, verifies the functionality of 

Multiprocessing Chip Sun’s multi-processing CPUs. There are four test Options to mptest: 

Lock/Unlock, Data I/O, FPU Consistency, and Cache Consistency. As with 
other Sundiag tests, you can specify options in either of two ways — from the 
SunView Sundiag window interface or with command-line arguments. 

Running Sundiag From Sundiag automatically probes for multiprocessing CPUs when it is brought up. 

Window Interface If a multiprocessing CPU is found, mptest is displayed as an available test in 

the Sundiag SunView window. Next to the mptest entry is an Options button. 
If that button is selected with the Left mouse button, the following Option Menu 
appears: 
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Figure C-1 mptest Option Menu 



Conf1gurat1ons: 

# of processors: 4 
Processor 0 0 enable 
Processor 1 0 enable 
Processor 2 C enable 
Processor 3 0 enable 


Sub-tests: None 


Options: 

Lock/Unlock: 0 
Data I/O: 0 
FPU Check: C 
Cache Consistency: 0 

enable 

enable 

enable 

enable 

[Default] [ Done ) 



Configurations 


Subtests 


The processors available for test are listed here. The multi-processing test can be 
enabled/disabled for individual processors on this menu. The enable/disable tog¬ 
gle switch next to each processor is set by clicking the left mouse button on the 
arrow circle. Subtests There are no subtest currently supported by this test. 
Options The following options can be run singly or concurrently. 

No subtests are currently supported. 


Options 

Lock/Unlock 

Data I/O 

FPU Consistency 
Cache Consistency 


The following options are available for mptest: 

Each processor uses the SPARC atomic instruction Ids tub as a lock/unlock to 
write to a shared physical memory page. While one processor is attempting the 
write, the other processors are free spinning for their turn to write. 

Each processor, in turn, writes data to the disk. The other processors immedi¬ 
ately read and verify the data pattern. 

The processors under test do floating point and integer numeric computations 
simultaneously, and verify identical results. 

This option requires two or more processors to access the same physical address. 
This option verifies that a change in physical address by one processor is 
confirmed by another. 
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Command-line Syntax 


Sundiag mptest can be run from a SunView window or a TTY port; mptest 
can run from the conunand line using the following syntax: 

/usr/diag/sundiag/mptest T=n C=n M=a: standardjarguments 

Insert arguments for T, C, and M from the following table; see the Sundiag 2.3 
User's Guide - SunOS 4.1.2 for a description of standardjarguments. 

Argument Description 

T=n «is one of the following integers, representing the bit pattern of 

the test options to be enabled. If T= is not specified, the default is 
to enable all options 

1 = Shared Memory Enabled 

2 = Data I/O Enabled 

3 = Data I/O and Shared Memory Enabled 

4 = FPU Check Enabled 

5 = FPU Check and Shared Memory Enabled 

6 = FPU Check and Data I/O Enables 

7 = FPU Check, Data I/O, and Shared Memory Enabled 

8 = Cache Consistency Enabled 

9 = Cache Consistency and Shared Memory Enabled 

10 = Cache Consistency and Data I/O Enabled 

11= Cache Consistency, Data I/O, and Shared Memory Enabled 

12 = Cache Consistency and FPU Chick Enabled 

13 = Cache Consistency, FPU Check, and Shared Memory Enabled 

14 = Cache Consistency, FPU Check, and Data I/O Enabled 

15 = Cache Consistency, FPU Check, Data I/O, and Shared 
Memory Enabled. 

C=n n is one of the following integers, representing the bit pattern of 

the processors to be enabled. If C= is not specified, the default is 
to enable all available processors. 

1 = processorO Enabled 

2 = processorl Enabled 

3 = processor2 Enabled 

4 = processor3 Enabled 

5 = processorO and processor3 Enabled 

6 = processorl and processor2 Enabled 

7 = processorO, processorl, and processor2 Enabled 

8 = processor3 Enabled 

9 = processorO and processor3 Enabled 

10 = processorl and processor3 Enabled 

11= processorO, processorl, and processor3 Enabled 

12 = processor2 and processor3 Enabled 

13 = processorO, processor2, and processor3 Enabled 

14 = processorl, processor2, and processor3 Enabled 

15 = processorO, processorl, processor2, and processor3 Enabled 

M=x X is the test pattern expressed as a hexadecimal number. The range 

is from 0 to Oxff. The default is 0x10. 
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C.2. Error mptest may return one of the following error messages. These messages 

specify problem with specific command-line arguments: 

ERROR: Must be super-user 

User is not in super-user mode. 

Cannot open <file> 

The disk is full. The Data I/O test file can not create a /tmp 
directory, or open it if it exists. 

Couldn't map address space to device, <system error 
message> 

The mmap process, which maps the Data I/O test file to memory, has 
failed. 

Fail get share memory, <error number> 

Failure to get the shared memory segment. 

Fail to fork! 

A new process could not be spawned. 

Fail <single/double> precision FPU test, process 
<number>, processor <number>, observed = <pattern>, 
expected = <pattern> 

FPU test failed on a specify process, and processor. 

Fail to open /dev/kmem 

/dev/kmem could not be opened for Cache Consistency. 

Fail to open /dev/mem 

/dev/mem could not be opened for Cache Consistency. 

loctl error, errno = <number>, sys_errlist = <error 
message> 

The kernel support ioctl failed. 

Please specify the 'T=' argument again 

The integer specified for the "T=n" argument was not acceptable; 
enter another 

Please specify the 'C=n' argument again 

The integer specified for the "C=n" argument was not acceptable; 
enter another. 

Can not run Multi-Processors test! You need to 
enable at least two processors. 

There was an error in the non Multi-Processors environment. Add 
another processor from the mptest Option Menu, or by using the 
"C=n" option. 


$ 
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X/Open Conformance Statement (XCS- 

QUE-3.106) 


This appendix provides the X/Open Conformance Statement for all Sun and 
Sun-based software products that have received the XPG3 Component brand. 
X/Open’s publication procedure prints the conformance statement as a series of 
chapters, one for each component. Each component is assigned a specific chapter 
number. This appendix starts with the conformance statement for the Commands 
and Utilities component, which X/Open assigns to Chapter 3. The following 
XCS-QUE-3.106 conformance chapters are printed here: 

• Chapter 3: Commands and Utilities 

• Chapter 4: C Language 

• Chapter 5: Indexed Sequential Access Method 

• Chapter 8: Pascal Language 

• Chapter 9: Fortran Language 

• Chapter 10: SQL 

• Chapter 11: Terminal Interfaces 

• Chapter 12: Window Management 

• Chapter 14: Inter-Process Communication 

• Chapter 15: Source Code Transfer 

• Chapter 16-1: Ada Language (from Telesoft AB) 

• Chapter 16-2: Ada Language (from Verdix Corporation) 
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Chapter 3: COMMANDS AND UTILITIES 


PRODUCT IDENTIFICATION Product Identification SunOS 

Version/Release No. 4, from 4.1 on 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

CONFORMANCE Indicator of Compliance 

REFERENCE None 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

CONFORMANCE Volume 1 of XPG3 recognises that convergence of implementations towards a 

EXPECTATIONS common specification for commands and utilities is not yet complete and there¬ 

fore does not require a vendor to supply all of the commands and utilities (and 
individual options) specified in XPG3. 

This chapter explicitly identifies those commands and utilities not supplied by 
the vendor and any supplied which do not conform to the published specification. 
(Reference : XPG3 Volume 1 Page 1). 
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Section 3.1: BASIC UTILITIES 


3.1.1 SUPPORTED Question 1: Which of the basic utilities (non-development utilities) defined in 

COMMANDS the XPG are not provided with the implementation ? 

Answer: 

The iconv, mailx and mkfifo commands are not provided. 

Rationale 

The XPG Volume 1 states that “this volume in its current form is useful 
only as a guide to portability, but it is not possible to precisely define or test 
conformance to it’’. This question determines whether or not the implemen¬ 
tation provides a command of the name specified in the XPG, it does not 
attempt to determine whether it supports the semantics of that command. 
The (optional) development utilities are excluded from this question and are 
dealt with in the next section of the questionnaire. 

Reference 

XPG3 Volume 1 Page 1 - Introduction 


3.1.2 COMMAND BEHAVIOR Question 2: In what ways do the commands provided by the implementation 

behave differently from the specifications contained in the XPG? 

Answer: 

Command Behaviour Differences from XPG3 

at Uses /var/spool/cron/* instead of /usr/lib/cron/* 

batch Uses /var/spool/cron/* instead of /usr/lib/cron/* 

crontab Uses /var/spool/cron/* instead of /usr/lib/cron/* 

awk Not completely 8-bit clean 

pack Accepts file names up to 12 bytes long 

sh The ulimit built-in is not provided 

Rationale 

This question provides a greater degree of granularity than the previous 
question, requiring the semantic differences associated with the commands 
to be specified. Again, the question relates to the basic utilities rather than 
the development utilities. The question only relates to the semantics of the 
options specified within the XPG; implementation specific extensions should 
not be documented. 
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Section 3.2: DEVELOPMENT UTILITIES 


3.2.1 SUPPORTED Question 3: Which of the development utilities defined in the XPG are not pro- 

COMMANDS vided with the implementation? 

Answer: 

The optional dis and sdb utilities are not provided. 

Rationale 

The XPG Volume 1 states that “The development utilities might not be 
present in all X/Open compliant systems; in designated (DEVELOPMENT) 
systems all of the development utilities must be present and must conform to 
the published definition’’. 

Reference 

XPG3 Volume 1 Page 2 - Status of Interfaces 

3.2.2 COMMAND BEHAVIOR Question 4: In what ways do the development utilities provided by the imple¬ 

mentation behave differently from the specifications contained in the XPG? 

Answer: 


Command 

Option 

Behaviour Differences from XPG3 

admin 

-a .'name 

-fi[str] 

-fllist 

Not supported 

Optional string argument not supported 

Does not provide all generality specified by XPG3 

cc 

-f 

Requires option argument specifying type of 
floating point support to be provided 

lex 


Not 8-bit clean 

lint 

-oLIB 

Creates library with name llib-lLIB.ln 
as in all known historical implementations 
instead of with name LIB as specified by XPG3 

make 


Search order for makefiles is 

makefile, SCCS/s.makefile, Makefile, SCCS/s.Makefile 
instead of makefile. Makefile, s.makefile, s.Makefile 

nm 

-e 

-f 

Not supported 

Not supported 


Rationale 

This question provides a greater degree of granularity than the previous 
question, requiring the semantic differences associated with the development 
utilities to be specified. 
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3.3.1 COMMANDS AND 
UTILITIES 


Command 

ar 

awk 

comm 

cp,ln,mv 

cpio 

date 

ed,red 

egrep 

expr 

fgrep 

find 

grep 

join 

Ipstat 

Is 


Section 3.3: INTERNATIONALISATION OPTION 


Question 5: Is an internationalised environment, reflecting changes in the 
locale setting as described in XPG Volume 1 - XSI Commands and Utilities, 
supported? 

Answer: 

Sun does not claim support for internationalised commands and utilities in 
SunOS 4, although the following table does indicate that some of the options 


described in XPG3 are supported in this release. 

Behaviour Specified in XPG3 Supported 

LC_TIME affects date format No 

LC_COLLATE, LC_CTYPE affect regular expression matching No 
LC_COLLATE affects the behaviour of string comparisons No 

LC_NUMERIC affects the behaviour of the radix character No 

LC_COLLATE affects sorting sequence No 

LANG affects yes string No 

LC_COLLATE, LC_CTYPE affect filename pattern matching No 
LC_TIME affects date format No 

LC_TIME affects date formatting options No 

LC_COLLATE, LC_CTYPE affect regular expression matching No 
LC_CTYPE is used to determine whether characters are printable Yes 

LC_COLLATE, LC_CTYPE affect regular expression matching No 
LC_CTYPE is used to determine character classification Yes 

(alphabetic, upper-case, lower case) 

LC_COLLATE, LC_CTYPE affect regular expression matching No 
LC_COLLATE affects the behaviour of relational operators No 

LC_CTYPE is used to determine character classification Yes 

(alphabetic, upper-case, lower case) 

LANG affects yes string No 

LC_COLLATE, LC_CTYPE affect filename pattern matching No 

LC_COLLATE, LC_CTYPE affect regular expression matching No 
LC_CTYPE is used to determine character classification Yes 

(alphabetic, upper-case, 1 to discower case) 

LC_COLLATE affects sorting sequence No 

LC_TIME affects date format No 

LC_COLLATE affects sorting sequence No 

LC_CTYPE is used to determine whether a character is printable Yes 
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Command Behaviour Specified in XPG3 Supported 

LC_TIME affects date format No 

mail LC_TIME affects date format No 

mailx LC_COLLATE, LC_CTYPE affect filename pattern matching No 

LC_TIME affects date format No 

pg LC_COLLATE, LC_CTYPE affect filename pattern matching No 

pr LC_TIME affects date format No 

LC_CTYPE is used to determine whether a character is printable Yes 

ps LC_TIME affects date format No 

rm,rmdir LANG affects yes string No 

sed LC_COLLATE, LC_CTYPE affect regular expression matching No 

LC_CTYPE is used to determine whether a character is printable Yes 

sh LC_COLLATE, LC_CTYPE affect filename pattern matching No 

LC_CTYPE is used to determine whether a character is alphabetic Yes 

sort LC_COLLATE affects sorting sequence No 

LC_CTYPE affects character classification (alphabetic, upper Yes 

case, printing) 

LC_NUMERIC affects the determination of the radix character Yes 

tar LC_TIME affects date format No 

LANG affects yes string No 

tr LC_COLLATE, LC_CTYPE affect bracketed expressions No 

LC_CTYPE affects the definition of the character universe Yes 

uniq LC_COLLATE affects sorting sequence No 

uucp LC_TIME affects date format No 

uustat LC_TIME affects date format No 

wc LC_CTYPE is used to determine white-space characters Yes 

who LC_TIME affects date format No 

yacc LC_CTYPE is used to determine character classification Yes 

Rationale 


This behaviour is collectively optional; that is, it should be provided for all 
commands listed (subject to sections 3.1 and 3.2, which identify those com¬ 
mands not supplied by the vendor and those which do not fully support the 
X/Open specification). 

Reference 

XPG3 Volume 1 Pages 4-5 - Status of Interfaces. 
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3.3.2 REGULAR 
EXPRESSIONS IN 
COMMANDS 


Question 6: Which form of regular expression syntax is supported by those com¬ 
mands which use regular expressions? 

Answer: 


Command Regular Expression Syntax Supported 

awk Extended 

csplit Simple 

ed Simple 

egrep Extended 

ex Simple 

expr Simple 

grep Simple 

lex Extended 

pg Simple 

sed Simple 

vi Simple 

Rationale 

The XPG Volume 3 - XSI Supplementary Definitions requires that an inter¬ 
nationalised set of commands will provide regular expression syntax for the 
above commands in one of the forms specified for that command. The XPG 
encourages the implementation of internationalised regular expressions for 
all of the above utilities. It should be noted that the sdb command is an 
optional development utility and may not be available on all XPG conform¬ 
ing systems. 

Reference 

XPG3 Volume 3 Pages 49-51 - Regular Expressions 
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PRODUCT IDENTIFICATION 


CONFORMANCE 

REFERENCE 


ENVIRONMENT 

SPECIFICATION 


TEMPORARY WAIVERS 


4.1 IMPLEMENTATION 
LIMITS 


Chapter 4: C LANGUAGE 

t 


Product Identification C compiler bundled with SunOS 
Version/Release No. 4, from 4.1 on 

If you do not supply this component yourself, please identify below the supplier 
you reference. 


Indicator of Compliance 
VSX Test Suite Release 
Testing Agency Name 
Address 


3.203 

Sun Microsystems 

2550 Garcia Avenue 
Mountain View CA 94043 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

Question 1: What limits does the implementation impose on the significant part 
of a identifier? 

Answer: 

External identifiers 32 characters 

Non-External identifiers 127 characters 

Rationale 

The XPG states that, while there is no limit to the length of an identifier, 
only a certain number of characters are significant. The XPG points out that 
there must be at least eight characters for a non-external name, but may be 
less for external names. 

Reference 

XPG 3 Volume 4 Page 3 - Lexical Conventions 
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4.2 GENERAL 


Question 2: What truncation rules are applied when a floating value is con¬ 
verted to an integral value? 

Answer: 

Truncation of floating point values is always towards zero. 

Rationale 

The XPG states that such conversions are machine dependent. In particular, 
the XPG points out the differences related to the truncation of negative 
numbers. 

Reference 

XPG Volume 4 Page 10 - Conversions 

Question 3: What truncation rules are applied when using the division operator 
and either of the operands is negative? 

Answer: 

Truncation towards zero 
Rationale 

The XPG states that such truncations are machine dependent. 

Reference 

XPG Volume 4 Page 16 - Expressions 
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PRODUCT IDENTIFICATION 


CONFORMANCE 

REFERENCE 


ENVIRONMENT 

SPECinCATION 


TEMPORARY WAIVERS 


5.1 IMPLEMENTATION 
LIMITS 


Chapter 5: INDEXED SEQUENTIAL ACCESS METHOD 


Product Identification NetlSAM 
Version/Release No. 1.0 and subsequent releases 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Indicator of Compliance 

VSX Test Suite Release 3.201 

Testing Agency Name Sun Microsystems 

Address 2550 Garcia Avenue 

Mountain View CA 94043 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

Question 1: What limits does the implementation impose for the following 


aspects? 

Answer: 

Number of key parts in an index NPARTS 8 

Maximum size of a key MAXKEYSIZE 150 

Maximum number of indices per file — 16 

Maximum size of data record — 8192 

Maximum number of concurrently locked records — 5000 

Maximum number of ISAM files that can be 

concurrently open — 128 
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Rationale 

The XPG states that the values for NPARTS and MAXKEYSIZE are imple¬ 
mentation specific but must be at least 8 and 120 respectively. The XPG 
states that the definition puts no limit on the number of alternative indices 
that can be created for a file. However, it is known that some implementa¬ 
tions impose a limit rather than allowing for a potentially infinite number of 
indices. The XPG also remains silent about the maximum length of a data 
record, though it is again known that some implementations impose a limit. 
The XPG states that the number of records that may be concurrently locked 
when a file has been opened with ISMANULOCK set is system dependent. 
This number may depend on the locks that are concurrently applied to other 
files and the number specified in the answer should be the maximum number 
of concurrently locked records that could be attained. The XPG states that an 
application program must be able to have at least ten ISAM files con¬ 
currently open. This limit assumes that the process has no other files open. 
The limit given in answer to the above question must also be based upon this 
assumption. 

Reference 

XPG 3 Volume 5 Page 61 - The <isam.h> Header 
XPG 3 Volume 5 Page 7 - ISAM Overview 
XPG 3 Volume 5 Page 20 - Manual Record Locking 
XPG 3 Volume 5 Page 71 - Files. 
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Chapter 8: PASCAL LANGUAGE 


Product Identification Sun Pascal 
Version/Release No. 2.0 and subsequent releases 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Indicator of Compliance 

NIST Test Suite Release 5.1 

Testing Agency Name NIST 

Address Gaithersburg, MD 

NIST Certificate Number NIST-89/2663 

Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.0 on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

A temporary waiver has been granted for Sun Pascal, because the NIST testing 
was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted until 
December 6,1991. The X/Open reference number on the waiver request is: 

PG3.083 

The waiver request follows: 

Pascal is not tested by VSX; instead, X/Open accepts a NIST certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ¬ 
ten, the NIST certificate must be from a test run on a system that is XPG 
branded. We have a NIST certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 

We are requesting a temporary waiver for the Pascal component because the 
NIST certificate for our Pascal product is from a test run on a version of the 
operating system prior to the version that will be XPG branded. The Pascal 
product executes correctly on either version of the operating system; that is, 
the identical binary image of the Pascal compiler works correctly on the 
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version of the operating system that NIST used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem¬ 
porary waiver is removed not by fixing the product, but by asking NIST to 
re-test the product on the version of the operating system with the XPG 
brand. 

For example, suppose that Acme Computers had earned an XPG brand for 
ACME 0/S 6.3, but had asked NIST to test ACME PASCAL on ACME 0/S 
6.2 (which does not have an XPG brand). Acme Computers would not be 
able to get an XPG brand for ACME PASCAL until NIST re-tested the com¬ 
piler on ACME 0/S 6.3. Since the identical binary image of ACME PAS¬ 
CAL runs on both ACME 0/S 6.2 and ACME 0/S 6.3, it is clear that the 
lack of the XPG brand for ACME PASCAL does NOT reflect product qual¬ 
ity, but only the order in which testing was planned. Therefore, Acme Com¬ 
puters would request a temporary waiver allowing them to use the XPG 
brand on ACME PASCAL until such time as NIST completed the re-test of 
ACME PASCAL on ACME 0/S 6.3. 
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Chapter 9: FORTRAN LANGUAGE 


PRODUCT IDENTIFICATION r. ^ • o ^ 

Product Identification Sun Fortran 

Version/Release No. 1.3 and subsequent releases 

If you do not supply this component yourself, please identify below the supplier 
you reference. 


CONFORMANCE 

REFERENCE 


Indicator of Compliance 

NIST Test Suite Release 
Testing Agency Name 
Address 

NIST Certificate Number 


2.0 

NIST 

Gaithersburg, MD 
NIST-89/2004 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.0 running on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

A temporary waiver has been granted for Sun Fortran, because the NIST testing 
was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted until 
December 6, 1991. The X/Open reference number on the waiver request is: 

PG3.084 


The waiver request follows: 

Fortran is not tested by VSX; instead, X/Open accepts a NIST certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ¬ 
ten, the NIST certificate must be from a test run on a system that is XPG 
branded. We have a NIST certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 

We are requesting a temporary waiver for the Fortran component because 
the NIST certificate for our Fortran product is from a test run on a version of 
the operating system prior to the version that will be XPG branded. The 
Fortran product executes correctly on either version of the operating system; 
that is, the identical binary image of the Fortran compiler works correctly on 
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the version of the operating system that NIST used to run their tests, and on 
the version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem¬ 
porary waiver is removed not by fixing the product, but by asking NIST to 
re-test the product on the version of the operating system with the XPG 
brand. 

For example, suppose that Acme Computers had earned an XPG brand for 
ACME O/S 6.3, but had asked NIST to test ACME FORTRAN on ACME 
0/S 6.2 (which does not have an XPG brand). Acme Computers would not 
be able to get an XPG brand for ACME FORTRAN until NIST re-tested the 
compiler on ACME O/S 6.3. Since the identical binary image of ACME 
FORTRAN runs on both ACME O/S 6.2 and ACME O/S 6.3, it is clear that 
the lack of the XPG brand for ACME FORTRAN does NOT reflect product 
quality, but only the order in which testing was planned. Therefore, Acme 
Computers would request a temporary waiver allowing them to use the XPG 
brand on ACME FORTRAN until such time as NIST completed the re-test 
of ACME FORTRAN on ACME O/S 6.3. 
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Chapter 10: SQL 


PRODUCT IDENTinCATION „ ^ x ^ x • 

Product Identincation Informix OnLine 

Version/Release No. 4.0 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Informix Software Inc 
4100 Bohannon Drive 
Menlo Park CA 94025 


CONFORMANCE 

REFERENCE 


Indicator of Compliance 
None 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 
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Chapter 11: TERMINAL INTERFACES 


PRODUCT IDENTIFICATION 


Product Identification SunOS 

Version/Release No. 4, from 4.1 on 

If you do not supply this component yourself, please identify below the supplier 
you reference. 


CONFORMANCE Indicator of Compliance 

REFERENCE None 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 mnning on a Sun4 


TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 
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Chapter 12: WINDOW MANAGEMENT 


PRODUCT IDENTinCATION ^ ^ ^ 

Product Identification OpenWmdows 

Version/Release No. 1.0 and subsequent releases 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

CONFORMANCE Indicator of Compliance 

REFERENCE None 

ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 

REFERENCE 

ENVIRONMENT 

SPECIFICATION 


TEMPORARY WAIVERS 


Chapter 14: INTER PROCESS COMMUNICATION 


Product Identification SunOS 

Version/Release No. 4, from 4.1 on 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Indicator of Compliance 
None 

Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.1 running on a Sun4 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 
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15.1 UTILITIES 
PRODUCT IDENTIFICATION 


CONFORMANCE 

REFERENCE 

ENVIRONMENT 

SPECIFICATION 


TEMPORARY WAIVERS 


FORMATS 


Chapter 15: SOURCE CODE TRANSFER 


Product Identification SunOS 
Version/Release No. 4, from 4.1 on 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Indicator of Compliance 
None 

Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

For Source Code Transfer software: 

SunOS 4.1 running on a Sun4 

For floppy disk hardware: 

SPARCstation with internal floppy disk drive (part number X554H) or with 
external floppy disk subsystem (part number 550D-S) 

For magnetic tape hardware: 

SPARCserver Office server or Datacenter server (Sun 4/260, Sun 4/280, Sun 
4/390 or Sun 4/490) with 1/2-inch tape drive subsystem (part number 675A) 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

Question 1: Which exchange media format(s) may be written by the system? 

Answer: 

80 track floppy disk Yes 

40 track floppy disk No 

IbOObpi PE magnetic tape Yes 
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Rationale 

XPG3 states that standards are referenced for transfer of floppy discs and 
magnetic tapes between machines. Because of the different nature of 
X/Open conformant systems, it is not possible to define a single portable 
medium which is supported across the whole range of systems. 

Reference 

XPG3 Volume 3 Chapters 15, 16 and 17 
Question 2: Which exchange media format(s) may be read by the system? 

Answer: 

80 track floppy disk Yes 

40 track floppy disk No 

1600bpi PE magnetic tape Yes 

Rationale 

XPG3 states that standards are referenced for transfer of floppy discs and 
magnetic tapes between machines. Because of the different nature of 
X/Open conformant systems, it is not possible to define a single portable 
medium which is supported across the whole range of systems. In addition, 
some systems can read a wider range of formats that they can write. 

Reference 

XPG3 Volume 3 Chapters 15, 16 and 17 

UTILITIES Question 3: Which utilities are used to create and read the archive formats 

specified in XPG Volume 3 - XSI Supplementary Definitions.^ 

Answer: 

Format Creating Reading 

Extended tar pax pax 

Cpio pax and cpio pax and cpio 

Rationale 

There is no explicit definition as to the commands that must be used to 
create and retrieve these archives. On most systems this will be achieved by 
the tar and cpio commands. There are other commands available which pro¬ 
duce these archives. On some implementations the command may need a 
special option to enable reading of the specified formats with the “standard” 
option being to create archives which are backwards compatible with previ¬ 
ous versions of the command. 

Reference 
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XPG3 Volume 3 Chapter 18 

INVALID FILE NAMES Question 4: What file name is used to contain data from the archive in the case 

that the file name on the archive is invalid for the system on which the file hierar¬ 
chy is being created? 

Answer: 

Format File Name 

Extended tar All legal file names in a USTAR archive are legal in the filesystem. 

Cpio All legal file names in a cpio archive are legal in the filesystem. 

Rationale 

Because an archive can contain non-portable file names it is necessary for an 
archive reading utility to be able to generate a file and store the data associ¬ 
ated with a non-portable file name when this is encountered on the archive. 
There may be a need to generate a number of such file names in the same 
directory and the specification should detail the algorithm used to generate 
these file names. 

Reference 

XPG3 Volume 3 Pages 151,155 

MULTI VOLUME ARCHIVES Question 5: How does the archive reading utility determine which file to read as 

the next volume when an end-of-file or end-of-media condition is encountered? 

Answer: 

Format Method 

Extended tar The pax utility prompts the user for the pathname of the 

next file in the archive. (The path need not name a device.) 

Cpio The cpio and pax utilities prompt the user for the pathname of 

the next file in the archive. (The path need not name a device.) 


Options: 

Description of method used by each utility. 

Refer to: POSIX.l Conformance Document Section 10.1.3. 

Rationale: 

In many cases the utility will prompt the user for the path name of the device 
to use for the next volume. There may be extensions to the utility syntax 
which allow the definition of alternate addresses for subsequent volumes. 
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Chapter 16: ADA LANGUAGE 


PRODUCT IDENTIFICATION 


Product Identification TeleGen2 Ada Development System 
Version/Release No. 1.4 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

TeleSoft 

CONTACT; Joan Giannetta 
5959 Cornerstone Court West 
San Diego CA 92121 


CONFORMANCE 

REFERENCE 


Indicator of Compliance 

ADA Joint Program Office 

Test Suite Release 1.10 


Testing Agency Name Wright-Patterson AFB Ada Validation Facility 

Address Wright-Patterson Air Force Base 

Dayton OH 


ADA Joint Program Office 
Certificate Number 


890801W1.10134 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 

Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.0 running on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 

minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

A temporary waiver has been granted for TeleSoft TeleGen2, because the AJPO 
testing was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is 
granted until December 6, 1991. The X/Open reference number on the waiver 
request is: 


PG3.085 


The waiver request follows: 

Ada is not tested by VSX; instead, X/Open accepts an AJPO certificate as 
the indicator of compliance. As the Trade Mark License Agreement is 
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written, the AJPO certificate must be from a test run on a system that is XPG 
branded. We have an AJPO certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 

We are requesting a temporary waiver for the Ada component because the 
AJPO certificate for our Ada product is from a test run on a version of the 
operating system prior to the version that will be XPG branded. The Ada 
product executes correctly on either version of the operating system; that is, 
the identical binary image of the Ada compiler works correctly on the ver¬ 
sion of the operating system that AJPO used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem¬ 
porary waiver is removed not by fixing the product, but by asking AJPO to 
re-test the product on the version of the operating system with the XPG 
brand. 

For example, suppose that Acme Computers had earned an XPG brand for 
ACME 0/S 6.3, but had asked AJPO to test ACME ADA on ACME O/S 6.2 
(which does not have an XPG brand). Acme Computers would not be able 
to get an XPG brand for ACME ADA until AJPO re-tested the compiler on 
ACME O/S 6.3. Since the identical binary image of ACME ADA runs on 
both ACME O/S 6.2 and ACME O/S 6.3, it is clear that the lack of the XPG 
brand for ACME ADA does NOT reflect product quality, but only the order 
in which testing was planned. Therefore, Acme Computers would request a 
temporary waiver allowing them to use the XPG brand on ACME ADA until 
such time as AJPO completed the re-test of ACME ADA on ACME O/S 6.3. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 

REFERENCE 


ENVIRONMENT 

SPECIFICATION 


TEMPORARY WAIVERS 


Chapter 16: ADA LANGUAGE 


Product Identification Verdix Ada Development System VAda-110-4040 
Version/Release No. 6.0 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Verdix Corporation 
CONTACT: Roger Baker 
14130-A Sully field Circle 
Chantilly VA 22021 

Indicator of Compliance 

ADA Joint Program Office 
Test Suite Release 

Testing Agency Name 

Address 

ADA Joint Program Office 
Certificate Number 


1.10 

Wright-Patterson AFB Ada Validation Facility 

Wright-Patterson Air Force Base 
Dayton OH 

890216W1.10030 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 

SunOS 4.0 running on a Sun4 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail¬ 
able with this document on request. 

A temporary waiver has been granted for Verdix VADS, because the AJPO test¬ 
ing was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted 
until December 6, 1991. The X/Open reference number on the waiver request is: 

PG3.085 


The waiver request follows: 

Ada is not tested by VSX; instead, X/Open accepts an AJPO certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ¬ 
ten, the AJPO certificate must be from a test run on a system that is XPG 
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branded. We have an AJPO certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 

We are requesting a temporary waiver for the Ada component because the 
AJPO certificate for our Ada product is from a test run on a version of the 
operating system prior to the version that will be XPG branded. The Ada 
product executes correctly on either version of the operating system; that is, 
the identical binary image of the Ada compiler works correctly on the ver¬ 
sion of the operating system that AJPO used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem¬ 
porary waiver is removed not by fixing the product, but by asking AJPO to 
re-test the product on the version of the operating system with the XPG 
brand. 

For example, suppose that Acme Computers had earned an XPG brand for 
ACME 0/S 6.3, but had asked AJPO to test ACME ADA on ACME 0/S 6.2 
(which does not have an XPG brand). Acme Computers would not be able 
to get an XPG brand for ACME ADA until AJPO re-tested the compiler on 
ACME O/S 6.3. Since the identical binary image of ACME ADA runs on 
both ACME O/S 6.2 and ACME O/S 6.3, it is clear that the lack of the XPG 
brand for ACME ADA does NOT reflect product quality, but only the order 
in which testing was planned. Therefore, Acme Computers would request a 
temporary waiver allowing them to use the XPG brand on ACME ADA until 
such time as AJPO completed the re-test of ACME ADA on ACME O/S 6.3. 
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